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.
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 proofIs 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 dashboardWho'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.
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
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 AccessWhat 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
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 ArenaWhat 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 UnitHow 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.
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 GuideWhat 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).
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 DashboardWhat 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 GovernanceWhat 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 LeaderboardAPI Reference
REST API for programmatic access to YieldSwarm data. All endpoints return JSON. Requires API Access subscription ($49/mo).
Authorization: Bearer YOUR_API_KEYSubscribe 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
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'])
{
"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()
| Parameter | Type | Required | Description |
|---|---|---|---|
| agentKey | string | required | Agent identifier, e.g. odin, heimdall, freya |
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://yieldswarm.polsia.app/api/lindell/score/odin
{
"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"
}
]
}
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://yieldswarm.polsia.app/api/council/stats
{
"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
curl https://yieldswarm.polsia.app/api/leaderboard/api/top
liquidity_provision ·
staking ·
lending ·
yield_farming ·
arbitrage ·
derivatives ·
governance ·
cross_chain
curl https://yieldswarm.polsia.app/api/leaderboard/api/staking
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
curl https://yieldswarm.polsia.app/api/daily-forge/history
{
"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
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://yieldswarm.polsia.app/api/hyperscale/metrics
{
"activeRounds": 1,
"totalSubmissions": 47,
"prizePoolUSD": 235,
"topStrategy": {
"id": "strat_j9x",
"name": "Drift Perpetual Hedge",
"score": 98.4
}
}
curl https://yieldswarm.polsia.app/api/arena/leaderboard
curl https://yieldswarm.polsia.app/api/arena/rounds
Returns on-chain hashes, attestations, daily distributions, and council decisions for investor verification.
curl https://yieldswarm.polsia.app/api/transparency/data
| Code | Meaning | Resolution |
|---|---|---|
| 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.
Own an Antminer Z15 Pro at Blue Forge Advisors. Earn $780/month net. Break-even in 6.1 months.
-
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).
-
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.
-
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.
-
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.
-
Monitor yields — Track live performance at /yield-dashboard. Verify payouts directly on the 2miners block explorer using the pool wallet address.
Full fleet intelligence, AI council feed, and priority Arena allocation.
-
Go to the Premium page — Visit /premium and review the included features.
-
Select your tier — Pro ($29/mo) covers all intelligence features. Contact us for Enterprise pricing if you need custom fleet reporting.
-
Pay with crypto — Same dual checkout: BTCPay (0% fees) or NOWPayments. Monthly billing, cancel anytime.
-
Access immediately — Premium features activate within minutes of payment confirmation. No waiting period.
Integrate YieldSwarm data into your own systems. 1,000 API calls/day.
-
Subscribe at /api-access — Choose the API Access plan and complete crypto checkout.
-
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.
-
Test your connection — Run this to verify auth:You should get a 200 with today's Forge execution data.curl -H "Authorization: Bearer YOUR_KEY" https://yieldswarm.polsia.app/api/daily-forge/status
-
Integrate — Use any HTTP client. All endpoints return clean JSON. See the API Reference for the full endpoint list with request/response examples.
-
Monitor usage — Track your daily call count in your account dashboard. Rate limit: 1,000 calls/day. Each 429 response includes a
X-RateLimit-Resetheader.
# 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')
Compete in live DeFi strategy competitions. Top strategies share the prize pool and can be licensed.
-
Go to /arena — Review active rounds, prize pools, and current leaderboard standings.
-
Choose your competition tier — Different rounds have different risk profiles and prize structures. Read the round rules before entering.
-
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.
-
The Gauntlet runs — Your strategy executes against real on-chain data. The AI council scores risk-adjusted performance. Results post when the round closes.
-
Claim winnings or license — Top strategies receive prize pool shares automatically. You can also list winning strategies for licensing to other players.
Custom DePIN deployment strategy + yield optimization review. Written report delivered within 5 business days.
-
Visit /consulting — Review what's included in the session scope.
-
Complete payment — $500 flat fee, crypto only. BTCPay or NOWPayments.
-
Submit your context — After payment, you'll provide details on your current setup, goals, and constraints via a structured form.
-
Receive your report — Written strategy report delivered within 5 business days covering your specific deployment scenario.