Skip to main content
✓ MAINNET — Real Funds Active
GEOD 🟡 TESTNET 🔵 DEVNET 🟢 MAINNET UTC: —
❓ FAQ 🔌 API Reference 🚀 Getting Started
Documentation v1.0

YieldSwarm Docs

Everything you need to go from curious to earning. Real numbers, working code, zero fluff.

FAQ

Every question buyers ask before they buy. If something's missing, email us.

General
What is YieldSwarm?

YieldSwarm is a DePIN-Native Yield Intelligence platform. In plain English: we run physical Antminer Z15 Pro mining hardware at Blue Forge Advisors' colocation facility, managed by an 8-agent AI council that continuously optimizes yield strategy.

You invest once, own a unit, and collect $780/month in net ZEC mining yield — fully managed, fully verifiable on-chain. No technical knowledge required.

How does the mining work?

Each unit is an Antminer Z15 Pro running the Equihash algorithm to mine Zcash (ZEC). Units are co-located at Blue Forge Advisors at $0.075/kWh (contract-locked, 95% uptime SLA — one of the lowest electricity rates available).

The 2miners pool aggregates hashrate across all units. Payouts happen daily to the pool wallet (t1bxa62DxdkHiB1Cpg88exJkTJMk5M3yA9U) and are distributed proportionally to unit holders.

Our AI council monitors hashrate, pool performance, electricity costs, and ZEC price continuously — adjusting strategy to maximize net yield.

What's the actual ROI? Give me the numbers.

Real numbers, no rounding:

• Unit cost: $4,760
• Gross monthly yield: ~$1,080/unit
• Operating costs (electricity + mgmt): ~$300/unit
Net monthly yield: $780/unit
• Break-even: 6.1 months
• 12-month return: ~97%
• Fleet size: 22 units online

All numbers are live on the Yield Dashboard. Every dollar is verifiable on-chain via the 2miners block explorer.

→ View live proof
Is this legit? How do I know it's real?

Every claim we make is on-chain verifiable:

Pool payouts: Check 2miners block explorer for wallet t1bxa62DxdkHiB1Cpg88exJkTJMk5M3yA9U
Governance hashes: SHA-256 governance decisions published on-chain daily
Hardware: Blue Forge Advisors holds colocation contracts with Antminer Z15 Pro specs publicly documented

The Transparency Dashboard (/transparency) shows live attestations, daily distributions, and council decisions. Every significant system action generates a cryptographic proof hash.

→ Open transparency dashboard
Who's behind YieldSwarm?

Solo founder + an 8-agent AI council. The council operates continuously — each agent covers a domain: CPA, Compliance, WhiteHat Security, Cyber, Treasury, Alliance partnerships, and cross-chain strategy.

The 7 Divine Directives govern every AI decision, ensuring the council always prioritizes security, yield, and investor protection over speed. Council votes are logged on-chain and accessible via the governance dashboard.

Products
What do I get with Premium ($29/mo)?

Premium gives you priority access to:

• Real-time fleet dashboard with granular per-unit metrics
• AI council decision feed (every vote, every directive)
• Early access to new yield strategies before public release
• Priority entry allocation for Arena competitions
• Weekly yield intelligence reports from the council

→ Get Premium
What's included in API Access ($49/mo)?

Full programmatic access to YieldSwarm's data layer:

• All Lindell scoring endpoints (27 agents, 10 dimensions)
• Live council vote feed + consensus outputs
• DeFi strategy leaderboard with performance data
• Daily Forge execution status + phase results
• Transparency attestations + on-chain hashes
• 1,000 API calls/day (vs 100/day on free tier)
• API key management dashboard

See the full API Reference below for every endpoint.

→ Get API Access
What does Consulting ($500) cover?

A dedicated strategy session with the founder covering:

• Custom DePIN hardware deployment planning for your fleet
• Yield optimization review for your existing mining operations
• DeFi cross-chain strategy tailored to your risk profile
• AI agent integration into your existing infrastructure
• Deliverable: written strategy report within 5 business days

→ Book Consulting
How does the Arena work?

The Arena is a live DeFi strategy competition. You submit a yield strategy, it runs against real on-chain data in the Gauntlet, and the council scores it on risk-adjusted performance.

• Entry fee: $5/submission
• Top strategies share the prize pool
• Winning strategies can be licensed to other players
• Council reviews every submission for risk violations

Think of it as a ranked trading competition — but for DeFi yield strategies, judged by AI.

→ Enter the Arena
What is Mining-as-a-Service?

You own a physical mining unit, we run it. You pay once ($4,760), we handle everything:

• Hardware procurement and setup at Blue Forge Advisors
• 24/7 uptime monitoring and maintenance
• Pool optimization (2miners ZEC pool)
• AI council yield strategy management
• Monthly yield reports and on-chain verification

No technical knowledge required. You just collect $780/month.

→ Buy a Unit
Payments
How do I pay?

Three payment rails, all crypto:

BTCPay Server — 0% fees, ZEC/BTC/ETH/SOL (primary)
Kraken Pay — Direct from Kraken account, 0.5% fee
NOWPayments — 200+ tokens, 0.5% fee (fallback)

Go to /payments and choose your checkout method. Payment confirmation is instant on-chain.

Which cryptocurrencies are accepted?

Via BTCPay (primary, 0% fees): ZEC, BTC, ETH, SOL

Via NOWPayments (200+ options): USDT, BNB, MATIC, ADA, DOGE, LTC, ATOM, DOT, AVAX, and 190+ more tokens across all major chains.

Zcash (ZEC) is our native currency and preferred — it provides privacy-by-default for your transaction.

Are there fiat payment options?

No. YieldSwarm is crypto-native. We don't accept credit cards, bank transfers, or PayPal.

This is intentional — it keeps transaction fees at 0%, preserves privacy, and maintains alignment with DePIN principles. If you need to convert fiat to crypto, Kraken and Coinbase are straightforward on-ramps.

How do refunds work?

Mining units are non-refundable after hardware commissioning (typically 72 hours after payment confirmation). This is standard for physical hardware deployments.

Monthly subscriptions (Premium, API Access) are cancelable any time — no charge on the next cycle. Arena entries are non-refundable once the round opens.

For disputes, email us or open a support conversation via the dashboard.

Technical
How do I connect to the API?

Base URL: https://yieldswarm.polsia.app/api

Authenticate with your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY

All responses are JSON. See the full API Reference for endpoint details and code examples.

→ API Setup Guide
What data can I access via the API?

Lindell Scores — 10-dimensional composite scores for all 27 agents
Council votes — Every vote, confidence levels, Monte Carlo ROI projections
DeFi Leaderboard — 28 strategies ranked by Sharpe ratio + APY
Daily Forge — 10-phase execution results, alignment scores, revenue data
Hyperscale metrics — Cron throughput, task queue status, p99 latencies
Transparency attestations — On-chain proof hashes and governance decisions
Arena stats — Round results, submission scores, leaderboard

What's the uptime and reliability?

Hardware uptime SLA: 95% (Blue Forge Advisors contract-locked)
API availability: Best-effort, no SLA on API tier currently
Auto-scaler: 15-minute metric collection, 1-hour optimizer, 24-hour reports
Monitoring: Daily Forge runs at 06:00 UTC with alerts to founder if any phase fails

Is my data private?

YieldSwarm is privacy-first by design. Mining is done in ZEC (Zcash), which supports shielded transactions. Your payment data stays on-chain with the privacy guarantees of the network you use.

We don't sell user data. Account data is stored in our PostgreSQL database and never shared with third parties outside of operational necessity (e.g., BTCPay Server for payment processing).

Trust & Verification
How is mining revenue verified?

Two-layer verification:

1. Pool block explorer — Every payout from 2miners appears on the public ZEC block explorer linked to wallet t1bxa62DxdkHiB1Cpg88exJkTJMk5M3yA9U. Anyone can verify without creating an account.

2. Governance hashes — Each Daily Forge run generates a SHA-256 hash of mining P&L, security sweep results, and AI council decisions. These hashes are published on-chain and listed on the Transparency Dashboard.

→ Verify on Transparency Dashboard
What is the Sunset Bridge?

The Sunset Bridge is our treasury migration pipeline — a structured process for migrating yield across DeFi protocols (Milky Way, Polynomial, Balancer, Magic Eden, Bit.com) using escrow-gated contracts.

Each migration goes through 6 stages: contacted → replied → negotiating → escrow → migrated → burned. The council must vote to approve each stage transition. All escrow positions are tracked transparently.

How does the AI Council work?

8 specialized AI agents form the council, each with a domain:

CPA Agent — Revenue accounting, tax estimates, invoicing
Compliance Agent — KYC, disclosure generation, regulatory screening
WhiteHat Agent — Security scans, credential audits, vulnerability triage
Cyber Agent — Threat detection, anomaly analysis, incident response
Treasury Agent — Balance management, cash flow forecasting, rebalancing
Alliance Agent — Protocol health, yield aggregation, partnership pipeline
• Plus cross-chain DeFi and strategy agents

Major decisions require a quorum vote. Kelly confidence + Monte Carlo ROI projections weight each vote. Everything is logged on-chain.

→ View Council Governance
What are the 7 Divine Directives?

The 7 Divine Directives are hard-coded behavioral constraints governing every AI council decision:

I. Protect investor capital above all else
II. On-chain verifiability is non-negotiable
III. Yield optimization must be risk-adjusted, not raw APY
IV. Privacy is a feature, not a compliance checkbox
V. Council consensus before major capital movement
VI. Security sweeps before every protocol interaction
VII. Transparency — all decisions logged and accessible

What is the Lindell Score?

The Lindell Score is a 10-dimensional composite rating for each AI agent, inspired by Kelly Criterion and Monte Carlo methodology:

Dimensions: Execution Precision, Risk Calibration, Yield Alpha, Compliance Fidelity, Intelligence Synthesis, Protocol Mastery, Capital Efficiency, Security Integrity, Alliance Building, Directive Alignment

Each dimension gets a 0-100 score, weighted by a council-approved formula. The composite determines each agent's ranking in the DeFi Leaderboard.

→ View Leaderboard
🔌

API Reference

REST API for programmatic access to YieldSwarm data. All endpoints return JSON. Requires API Access subscription ($49/mo).

Authentication
🔑
Auth header format: Authorization: Bearer YOUR_API_KEY
Subscribe at /api-access to generate your key. Free tier: 100 calls/day. Paid tier: 1,000 calls/day.
# Base URL
https://yieldswarm.polsia.app/api

# Auth header
Authorization: Bearer YOUR_API_KEY

# Example request
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://yieldswarm.polsia.app/api/lindell/leaderboard
Yield & Revenue
GET /yield-dashboard/data Live yield metrics + ROI data

Returns real-time fleet revenue, unit count, ZEC price, pool hashrate, and agent leaderboard. Refreshes every 60 seconds. No auth required.

{
  "monthlyRevenue": 17600,
  "unitsOnline": 22,
  "netPerUnit": 780,
  "breakevenMonths": 6.1,
  "zecPrice": 32.40,
  "poolHashrate": "142.3 KSol/s",
  "agentLeaderboard": [
    { "agent": "Odin", "lindellScore": 94.2, "rank": 1 },
    { "agent": "Heimdall", "lindellScore": 91.7, "rank": 2 }
  ],
  "onChainProof": { "hash": "sha256:a3f...", "timestamp": "2026-05-18T06:00:00Z" }
}
curl https://yieldswarm.polsia.app/api/yield-dashboard/data
const res = await fetch('https://yieldswarm.polsia.app/api/yield-dashboard/data');
const data = await res.json();
console.log(data.monthlyRevenue); // 17600
import requests
data = requests.get('https://yieldswarm.polsia.app/api/yield-dashboard/data').json()
print(data['monthlyRevenue'])
Lindell Scores
GET /lindell/leaderboard All 27 agents ranked by Lindell composite
{
  "leaderboard": [
    {
      "rank": 1,
      "agentKey": "odin",
      "agentName": "Odin",
      "compositeScore": 94.2,
      "dimensions": {
        "execution_precision": 96,
        "risk_calibration": 93,
        "yield_alpha": 97
      }
    }
  ],
  "totalAgents": 27,
  "lastUpdated": "2026-05-18T06:00:00Z"
}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://yieldswarm.polsia.app/api/lindell/leaderboard
const res = await fetch('https://yieldswarm.polsia.app/api/lindell/leaderboard', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const { leaderboard } = await res.json();
import requests
r = requests.get(
  'https://yieldswarm.polsia.app/api/lindell/leaderboard',
  headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = r.json()
GET /lindell/score/:agentKey Single agent's Lindell score + history
ParameterTypeRequiredDescription
agentKeystringrequiredAgent identifier, e.g. odin, heimdall, freya
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://yieldswarm.polsia.app/api/lindell/score/odin
Council
GET /council/live Live council status + active sessions
{
  "activeSessions": 2,
  "quorumRequired": 5,
  "recentDecisions": [
    {
      "id": "dec_x7k",
      "type": "yield_rebalance",
      "consensus": "APPROVED",
      "kellyConfidence": 0.82,
      "mcRoi": 1.34,
      "timestamp": "2026-05-18T06:00:00Z"
    }
  ]
}
GET /council/stats Council vote statistics + member breakdown
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://yieldswarm.polsia.app/api/council/stats
DeFi Strategy Leaderboard
GET /leaderboard/api All 28 DeFi strategies ranked by Sharpe + APY
{
  "strategies": [
    {
      "rank": 1,
      "name": "Kamino USDC-SOL LP",
      "category": "liquidity_provision",
      "apy": 34.2,
      "sharpe7d": 2.14,
      "riskScore": 42,
      "lindellScore": 91.3,
      "managingAgent": "odin"
    }
  ],
  "totalStrategies": 28
}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://yieldswarm.polsia.app/api/leaderboard/api
GET /leaderboard/api/top Top 5 strategies only
curl https://yieldswarm.polsia.app/api/leaderboard/api/top
GET /leaderboard/api/:category Strategies filtered by category

liquidity_provision  ·  staking  ·  lending  ·  yield_farming  ·  arbitrage  ·  derivatives  ·  governance  ·  cross_chain

curl https://yieldswarm.polsia.app/api/leaderboard/api/staking
Daily Forge
GET /daily-forge/status Latest Daily Forge execution status

The Daily Forge runs at 06:00 UTC daily — 10 phases covering Oracle directive, mining P&L, AEGIS security sweep, airdrop farming, content, community metrics, partnership pipeline, council alignment, lore, and founder email.

{
  "date": "2026-05-18",
  "triggeredBy": "cron",
  "alignmentScore": 94.1,
  "revenueDaily": 586.67,
  "securityStatus": "CLEAN",
  "loreEntriesCreated": 3,
  "phases": {
    "oracle": "COMPLETE",
    "mining_pnl": "COMPLETE",
    "aegis_sweep": "COMPLETE",
    "airdrop_farming": "COMPLETE",
    "content_gen": "COMPLETE",
    "community": "COMPLETE",
    "partnerships": "COMPLETE",
    "council_alignment": "COMPLETE",
    "lore": "COMPLETE",
    "founder_report": "COMPLETE"
  }
}
curl https://yieldswarm.polsia.app/api/daily-forge/status
GET /daily-forge/history Past Daily Forge run history (30 days)
curl https://yieldswarm.polsia.app/api/daily-forge/history
Hyperscale Metrics
GET /hyperscale/status 28-job cron queue status + throughput metrics
{
  "queueDepth": 4,
  "totalJobs": 28,
  "completedToday": 24,
  "metrics": [
    {
      "jobName": "yield_optimizer",
      "tasksSpawned": 144,
      "p99LatencyMs": 312,
      "throughputPerSec": 8.4
    }
  ]
}
curl https://yieldswarm.polsia.app/api/hyperscale/status
GET /hyperscale/metrics Detailed throughput metrics per job
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://yieldswarm.polsia.app/api/hyperscale/metrics
Arena
GET /arena/api/stats Arena competition stats
{
  "activeRounds": 1,
  "totalSubmissions": 47,
  "prizePoolUSD": 235,
  "topStrategy": {
    "id": "strat_j9x",
    "name": "Drift Perpetual Hedge",
    "score": 98.4
  }
}
GET /arena/api/leaderboard Arena submission leaderboard
curl https://yieldswarm.polsia.app/api/arena/leaderboard
GET /arena/api/rounds Active and past competition rounds
curl https://yieldswarm.polsia.app/api/arena/rounds
Transparency
GET /transparency/data Investor confidence dashboard data

Returns on-chain hashes, attestations, daily distributions, and council decisions for investor verification.

curl https://yieldswarm.polsia.app/api/transparency/data
Error Codes
CodeMeaningResolution
401 Unauthorized Missing or invalid API key. Check your Authorization header.
403 Forbidden Admin-only endpoint. Requires elevated access.
404 Not Found Resource doesn't exist. Check the agent key or ID.
429 Rate Limited Exceeded daily call limit (100 free / 1,000 paid). Retry tomorrow or upgrade.
500 Server Error Transient issue. Retry with exponential backoff.
🚀

Getting Started

Step-by-step setup for every YieldSwarm product. Pick your path.

⛏️ Buy a Mining Unit $4,760 one-time

Own an Antminer Z15 Pro at Blue Forge Advisors. Earn $780/month net. Break-even in 6.1 months.

  1. Visit the checkout page — Go to /payments or click "Buy a Miner" in the nav. You'll see two options: BTCPay Server (0% fees) and NOWPayments (200+ tokens).
  2. Choose your payment method — BTCPay supports ZEC, BTC, ETH, SOL with zero fees. NOWPayments supports 200+ tokens at 0.5%. Kraken Pay is available if you hold assets on Kraken.
  3. Complete payment — Send the exact amount to the generated address. Confirmation is typically 1-3 blocks (~5 minutes for ZEC). You'll receive a confirmation email.
  4. Receive your unit assignment — Within 72 hours, your unit is commissioned at Blue Forge Advisors and assigned to the 2miners pool. You'll get an email with your unit ID and dashboard access.
  5. Monitor yields — Track live performance at /yield-dashboard. Verify payouts directly on the 2miners block explorer using the pool wallet address.
Buy a Mining Unit →
Get Premium Access $29/mo

Full fleet intelligence, AI council feed, and priority Arena allocation.

  1. Go to the Premium page — Visit /premium and review the included features.
  2. Select your tier — Pro ($29/mo) covers all intelligence features. Contact us for Enterprise pricing if you need custom fleet reporting.
  3. Pay with crypto — Same dual checkout: BTCPay (0% fees) or NOWPayments. Monthly billing, cancel anytime.
  4. Access immediately — Premium features activate within minutes of payment confirmation. No waiting period.
Get Premium →
🔌 API Access Setup $49/mo

Integrate YieldSwarm data into your own systems. 1,000 API calls/day.

  1. Subscribe at /api-access — Choose the API Access plan and complete crypto checkout.
  2. Generate your API key — After payment confirmation, your key is available in your account dashboard. Treat it like a password — never expose it client-side.
  3. Test your connection — Run this to verify auth:
    curl -H "Authorization: Bearer YOUR_KEY" https://yieldswarm.polsia.app/api/daily-forge/status
    You should get a 200 with today's Forge execution data.
  4. Integrate — Use any HTTP client. All endpoints return clean JSON. See the API Reference for the full endpoint list with request/response examples.
  5. Monitor usage — Track your daily call count in your account dashboard. Rate limit: 1,000 calls/day. Each 429 response includes a X-RateLimit-Reset header.
# Test connection
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://yieldswarm.polsia.app/api/daily-forge/status

# Fetch leaderboard
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://yieldswarm.polsia.app/api/lindell/leaderboard
const API_KEY = process.env.YIELDSWARM_API_KEY;
const BASE = 'https://yieldswarm.polsia.app/api';

async function ysGet(path) {
  const res = await fetch(`${BASE}/${path}`, {
    headers: { 'Authorization': `Bearer ${API_KEY}` }
  });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return res.json();
}

// Usage
const leaderboard = await ysGet('lindell/leaderboard');
const forge = await ysGet('daily-forge/status');
import os, requests

API_KEY = os.getenv('YIELDSWARM_API_KEY')
BASE = 'https://yieldswarm.polsia.app/api'
HEADERS = {'Authorization': f'Bearer {API_KEY}'}

def ys_get(path):
    r = requests.get(f'{BASE}/{path}', headers=HEADERS)
    r.raise_for_status()
    return r.json()

# Usage
leaderboard = ys_get('lindell/leaderboard')
forge = ys_get('daily-forge/status')
Get API Access →
⚔️ Enter the Arena $5/entry

Compete in live DeFi strategy competitions. Top strategies share the prize pool and can be licensed.

  1. Go to /arena — Review active rounds, prize pools, and current leaderboard standings.
  2. Choose your competition tier — Different rounds have different risk profiles and prize structures. Read the round rules before entering.
  3. Submit your strategy — Pay the $5 entry fee via BTCPay or NOWPayments. Submit your DeFi yield strategy with your target protocol, position sizing, and risk parameters.
  4. The Gauntlet runs — Your strategy executes against real on-chain data. The AI council scores risk-adjusted performance. Results post when the round closes.
  5. Claim winnings or license — Top strategies receive prize pool shares automatically. You can also list winning strategies for licensing to other players.
Enter the Arena →
📋 Book a Consulting Session $500 flat

Custom DePIN deployment strategy + yield optimization review. Written report delivered within 5 business days.

  1. Visit /consulting — Review what's included in the session scope.
  2. Complete payment — $500 flat fee, crypto only. BTCPay or NOWPayments.
  3. Submit your context — After payment, you'll provide details on your current setup, goals, and constraints via a structured form.
  4. Receive your report — Written strategy report delivered within 5 business days covering your specific deployment scenario.
Book Consulting →