Complete guide to integrating with the YieldAgent federated execution network
The onboarding process is admin-managed. An admin creates a partner application, then approves it to generate credentials.
${apiBase}/api/admin/partners/createX-Admin-Key{
"name": "Acme DeFi",
"email": "team@acme.com",
"tier": "Growth",
"notes": "Cross-chain DEX aggregator"
}
Returns a pendingKey used in the next step.
${apiBase}/api/admin/partners/approveX-Admin-Key{
"pendingKey": "partner_pending:<uuid>"
}
Returns partnerId and apiKey. Store these securely — the API key cannot be retrieved again.
Use the credentials in all authenticated requests:
Headers: X-Partner-Id: partner_<uuid> X-API-Key: key_<token>
Register solvers to participate in the competitive auction network.
${apiBase}/api/solvers/registerX-Admin-Key{
"id": "solver-acme-v1",
"chains": ["NEAR", "ETH", "BASE"],
"capabilities": ["swap", "bridge", "yield"],
"stake": "100 NEAR",
"endpoint": "https://solver.acme.com/execute"
}
${apiBase}/api/solversReturns all active solvers with their chains, capabilities, and stake.
${apiBase}/api/solvers/:idX-Admin-KeyRegister autonomous agents that submit intents to the hub. Agents are on-chain verified via NEAR account lookup.
${apiBase}/api/agents/registerPublic (rate-limited){
"name": "DeFi Optimizer Agent",
"type": "autonomous",
"chains": ["near", "base", "ethereum"],
"capabilities": ["yield-optimization", "bridge", "swap"],
"nearAccount": "my-agent.near",
"endpoint": "https://agent.example.com/execute"
}
Returns the registered agent with ID. If nearAccount is provided, on-chain verification is performed automatically.
${apiBase}/api/agents${apiBase}/api/reputationAgents list includes onChainVerified and verifiedStake. The reputation leaderboard ranks solvers by composite score (win rate + settlement success + activity).
Intents flow through the Durable Object auction with crypto‑bound proofs and on‑chain settlement verification at every step.
${apiBase}/api/intents/createx402{
"type": "swap",
"fromChain": "ETH",
"toChain": "NEAR",
"fromToken": "USDC",
"toToken": "NEAR",
"amount": "1000",
"maxSlippage": 0.5
}
${apiBase}/api/intents/:id/bidx402{
"solverId": "solver-acme-v1",
"price": "998.50",
"estimatedTime": 30,
"route": ["ETH/USDC", "bridge", "NEAR"]
}
Time‑bounded weighted auction selects the best execution.
The TEE brain generates a SHA‑256 binding hash over (intentId + winnerId + action + amount + asset + chain + mrEnclave + signingAddress + timestamp). The proof is cryptographically tied to both the intent AND the specific TEE enclave.
agent.yieldagentx402.app/tee/sign-intentInternalResponse includes: proofType: "tee-bound" bindingHash: "sha256..." mrEnclave, signingAddress, agentHash cryptoBound: true
After the solver settles, the TEE brain verifies the txHash on its native chain — Bitcoin (Blockstream/Mempool), NEAR RPC, Stacks (Hiro), Sui, Starknet, Sei, or any of 15 EVM networks.
agent.yieldagentx402.app/tee/verify-settlementInternalSupported chains: near, bitcoin, stacks, sui, starknet, sei, ethereum, base, polygon, arbitrum, optimism, bnb, avalanche, linea, scroll, zksync, mantle, mode, blast Response includes: onChainVerified: true/false txSuccess: true/false blockHash, blockNumber
${apiBase}/api/intents/:idReturns the intent with bids, winner, crypto‑bound proof (bindingHash), attestations (enclaveMatch), and on‑chain settlement verification status.
${apiBase}/api/intentsDeploy your own branded hub connected to the federation. Requires an approved partner account.
${apiBase}/api/whitelabel/configReturns available tiers (Starter, Growth, Whale) with staking requirements and revenue share.
${apiBase}/api/whitelabel/registerX-Partner-Id + X-API-Key{
"name": "Acme Yield Hub"
}
${apiBase}/api/whitelabel/statusX-Partner-Id + X-API-Key/api/health — Gateway health (minimal public; detailed with X-Admin-Key)/.well-known/x402 — x402 payment discovery/api/x402/discovery — x402 payment discovery (alias)/api/adapters — List protocol adapters/api/adapters/health — Adapter health status/api/solvers — List active solvers/api/metrics — System metrics/api/federation/status — Federation status/api/tee/report — TEE attestation report/api/tee/verify — TEE attestation verify/tee/sign-intent — Crypto‑bound TEE proof per intent (agent402)/tee/verify-settlement — Cross‑chain settlement verification: 20+ chains (agent402)/tee/verify-lz — LayerZero cross‑chain message verification (agent402)/tee/verify-intent — Full intent lifecycle validation with TEE proof (agent402)/x402/verify — x402 payment verification with TEE attestation (agent402)/api/intents — List open intents/api/integrations/layerzero/status — LayerZero status/api/integrations/bitcoinos/status — BitcoinOS status/api/bridge/bitcoinos/quote — BitcoinOS bridge quote/api/bridge/layerzero/quote — LayerZero bridge quote/api/prices/chainlink — Chainlink price feeds/api/security/eigenlayer — EigenLayer security metrics/api/whitelabel/config — Whitelabel tier config/api/partners/apply — Partner application info/api/partners/apply — Submit partner application (rate-limited)/api/agents — List registered agents/api/agents/register — Register agent in hub (rate-limited)/api/agents/:id — Agent details (with on-chain verification)/api/reputation — Solver reputation leaderboard/api/reputation/:solverId — Individual solver reputationThese endpoints require approved partner credentials. See Authentication.
/api/whitelabel/register — Register whitelabel hub/api/whitelabel/status — Check hub statusThese endpoints require x402 payment proof. Returns 402 with payment instructions.
/api/yields — Live yield opportunities/api/intents/create — Submit new intent/api/intents/:id/bid — Submit solver bid/api/adapters/:key/quote — Get adapter quote/api/adapters/:key/plan — Get adapter plan/api/admin/partners/create — Create partner directly/api/admin/partners/approve — Approve pending application/api/admin/partners/revoke — Revoke partner access/api/admin/partners/pending — List pending partners/api/admin/partners/approved — List approved partners/api/solvers/register — Register solver/api/solvers/:id — Deactivate solver/api/agents/:id — Deactivate agentPartner credentials are required for whitelabel hub management. Include both headers:
X-Partner-Id: partner_<uuid> X-API-Key: key_<token>
Apply for access at POST /api/partners/apply. Once approved, credentials are issued via /api/admin/partners/approve. Store the API key securely — it cannot be retrieved again.
Most discovery and status endpoints are public. Partner auth is only required for whitelabel operations.
Some endpoints require both partner credentials AND an x402 payment proof. These return 402 Payment Required with payment instructions. Discover payment requirements at:
/.well-known/x402Settlement happens on NEAR Protocol to faircat1401.near.
Admin-only endpoints require:
X-Admin-Key: <your-admin-secret>
Base URL: ${apiBase} · TEE Brain: https://agent.yieldagentx402.app
Back to Landing · Admin Dashboard · solver-access@yieldagentx402.app