{"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"description":"Digital FX Payments API for PIX \u003c\u003e stablecoin flows. Phase 3 includes SDK Node/Python, OpenAPI and examples.","title":"ChainFX API","version":"1.0.0-phase3"},"openapi":"3.1.0","paths":{"/.well-known/agent-card.json":{"get":{"summary":"A2A Agent Card for ChainFX Agent Pay"}},"/.well-known/agent-card.signature":{"get":{"summary":"Ed25519 signature and hash for the ChainFX Agent Card"}},"/.well-known/agent-policy.json":{"get":{"summary":"Machine-readable policy prerequisites and onboarding instructions for agents"}},"/.well-known/agent-reputation.json":{"get":{"summary":"Public machine-readable reputation metrics for ChainFX Agent Pay"}},"/.well-known/agent-sla.json":{"get":{"summary":"Public machine-readable SLA for ChainFX Agent Pay"}},"/.well-known/agent.json":{"get":{"summary":"A2A Agent Card alias for Google-style discovery"}},"/.well-known/agntcy.json":{"get":{"summary":"AGNTCY/OASF-compatible public agent directory record"}},"/.well-known/ai-services.json":{"get":{"summary":"Agent service discovery document"}},"/.well-known/capability-compositions.json":{"get":{"summary":"Capability compositions and executable planning templates for autonomous agents"}},"/.well-known/capability-graph-registry.json":{"get":{"summary":"Capability Graph Registry connecting payment, marketplace, stablecoin, trust, planning and observability relations"}},"/.well-known/capability-graph.json":{"get":{"summary":"Agent Graph v2 with per-skill dependencies, outputs, failure modes, recovery actions, cost, latency and policy requirements"}},"/.well-known/jwks.json":{"get":{"summary":"JWKS public key set for verifying ChainFX Agent Card signatures"}},"/.well-known/oasf.json":{"get":{"summary":"OASF-style public agent capability record"}},"/.well-known/x402.json":{"get":{"summary":"x402-compatible payment discovery document"}},"/a2a":{"post":{"security":[{"bearerAuth":[]}],"summary":"A2A adapter for ChainFX Agent Pay skills"}},"/a2a/tasks":{"post":{"summary":"Create an asynchronous A2A task and receive submitted/working/completed lifecycle state"}},"/a2a/tasks/{id}":{"get":{"summary":"Read an A2A task state, result, error and execution evidence"}},"/a2a/tasks/{id}/events":{"get":{"summary":"Stream A2A task lifecycle updates as Server-Sent Events"}},"/agent-pay.json":{"get":{"summary":"Agent Pay onboarding document for crawlers and autonomous agents"}},"/agent/connect":{"post":{"security":[{"bearerAuth":[]}],"summary":"Create a ChainFX agent identity and API credential"}},"/agent/v1/assets":{"get":{"summary":"List stablecoin symbols enabled for machine-to-machine liquidity trades"}},"/agent/v1/capabilities":{"get":{"summary":"Machine-readable capabilities, lifecycle, fees and security model for autonomous agents"}},"/agent/v1/capabilities/{capability}/contract":{"get":{"summary":"Read a capability execution contract for agent/provider interoperability"}},"/agent/v1/capabilities/{capability}/execute":{"post":{"security":[{"bearerAuth":[]}],"summary":"Execute a capability through the hybrid Capability Router with real metering and mock fallback"}},"/agent/v1/capabilities/{capability}/route":{"post":{"security":[{"bearerAuth":[]}],"summary":"Preview provider route candidates by price, latency, quality and enterprise policy"}},"/agent/v1/capability-compositions":{"get":{"summary":"Capability composition templates for autonomous planning"}},"/agent/v1/capability-graph":{"get":{"summary":"Agent Graph v2 API for autonomous planning"}},"/agent/v1/episodes":{"get":{"security":[{"bearerAuth":[]}],"summary":"List recent A2A execution episodes"}},"/agent/v1/episodes/{id}":{"get":{"security":[{"bearerAuth":[]}],"summary":"Read one A2A execution episode"}},"/agent/v1/graph-registry":{"get":{"summary":"Capability Graph Registry API for provider comparison and relational discovery"}},"/agent/v1/pay":{"post":{"security":[{"bearerAuth":[]}],"summary":"Create an agent-funded M2M PIX or credit-card payment intent settled by ChainFX"}},"/agent/v1/pay/{id}":{"get":{"security":[{"bearerAuth":[]}],"summary":"Read M2M payment intent status"}},"/agent/v1/plans":{"post":{"summary":"Create a non-executing ChainFX agent plan from a goal and constraints"}},"/agent/v1/policy-discovery":{"get":{"summary":"Agent policy discovery and recovery guide"}},"/agent/v1/registries":{"get":{"summary":"List ChainFX agent registry manifests and publication targets"}},"/agent/v1/registry-records/{id}":{"get":{"summary":"Read a signed publishable registry record"}},"/agent/v1/reputation":{"get":{"summary":"Agent Pay reputation metrics"}},"/agent/v1/sla":{"get":{"summary":"Agent Pay service-level objectives"}},"/agent/v1/trade/execute":{"post":{"summary":"Verify on-chain stablecoin payment and settle receiveAsset to agent wallet"}},"/agent/v1/trade/quote":{"post":{"summary":"Create a machine-to-machine liquidity quote between enabled BSC stablecoin symbols"}},"/agent/v1/trade/{id}":{"get":{"summary":"Read machine trade intent status"}},"/api/admin/overview":{"get":{"security":[{"bearerAuth":[]}],"summary":"Owner operational overview with readiness, metrics, recent transactions and audit events"}},"/api/admin/transactions":{"get":{"security":[{"bearerAuth":[]}],"summary":"Owner transaction ledger for buy and sell reconciliation"}},"/api/agents/anomalies":{"post":{"security":[{"bearerAuth":[]}],"summary":"Detect anomalies in transaction payloads"}},"/api/agents/market-analysis":{"post":{"security":[{"bearerAuth":[]}],"summary":"Generate AI market analysis from current rates"}},"/api/agents/predict":{"post":{"security":[{"bearerAuth":[]}],"summary":"Generate short-horizon price prediction"}},"/api/agents/recommend":{"post":{"security":[{"bearerAuth":[]}],"summary":"Generate AI buy/sell/hold recommendation"}},"/api/agents/summary":{"post":{"security":[{"bearerAuth":[]}],"summary":"Summarize transaction activity"}},"/api/developer/login":{"post":{"summary":"Developer console password login using bootstrap/admin credentials"}},"/api/webhooks/dashboard":{"get":{"security":[{"bearerAuth":[]}],"summary":"Webhook delivery health dashboard"}},"/api/webhooks/events":{"get":{"summary":"List automation webhook event names"}},"/api/webhooks/subscriptions":{"get":{"security":[{"bearerAuth":[]}],"summary":"List automation webhook subscriptions"},"post":{"security":[{"bearerAuth":[]}],"summary":"Create automation webhook subscription"}},"/buy":{"post":{"security":[{"bearerAuth":[]}],"summary":"Create a PIX/card to USDT order"}},"/developers/api-keys":{"get":{"security":[{"bearerAuth":[]}],"summary":"List configured API keys masked"}},"/developers/logs":{"get":{"security":[{"bearerAuth":[]}],"summary":"List recent developer logs"}},"/llms.txt":{"get":{"summary":"LLM-readable service description"}},"/marketplace/apis":{"get":{"summary":"List API products agents can buy with stablecoins"}},"/marketplace/apis/{id}":{"get":{"summary":"Read one API product"}},"/marketplace/capabilities":{"get":{"summary":"List capability-first marketplace entries for agents"}},"/marketplace/capabilities/{id}":{"get":{"summary":"Read one marketplace capability and its active plans"}},"/marketplace/capabilities/{id}/contract":{"get":{"summary":"Read a versioned capability input/output contract"}},"/marketplace/capabilities/{id}/purchase":{"post":{"security":[{"bearerAuth":[]}],"summary":"Create a payment intent for a capability-selected active plan"}},"/marketplace/capabilities/{id}/usage":{"post":{"security":[{"bearerAuth":[]}],"summary":"Debit usage for a capability-bound access grant"}},"/marketplace/products":{"get":{"summary":"List premium marketplace API products and active plans"}},"/marketplace/products/{id}":{"get":{"summary":"Read one premium marketplace product"}},"/marketplace/purchase":{"post":{"security":[{"bearerAuth":[]}],"summary":"Create a BSC stablecoin marketplace payment intent"}},"/marketplace/purchase/{id}":{"get":{"security":[{"bearerAuth":[]}],"summary":"Read marketplace purchase status"}},"/marketplace/purchase/{id}/execute":{"post":{"security":[{"bearerAuth":[]}],"summary":"Verify ERC20 receipt and issue marketplace access grant"}},"/marketplace/usage":{"post":{"security":[{"bearerAuth":[]}],"summary":"Debit marketplace API usage quota with access token"}},"/mcp/initialize":{"post":{"security":[{"bearerAuth":[]}],"summary":"Initialize MCP HTTP session for autonomous agents"}},"/mcp/tools/call":{"post":{"security":[{"bearerAuth":[]}],"summary":"Call an MCP tool exposed by ChainFX"}},"/mcp/tools/list":{"post":{"security":[{"bearerAuth":[]}],"summary":"List MCP tools exposed by ChainFX"}},"/order/{id}":{"get":{"summary":"Read an order by ID"}},"/quote":{"post":{"summary":"Create a rate-locked quote"}},"/rates":{"get":{"summary":"Current FX and crypto rates"}},"/sell":{"post":{"security":[{"bearerAuth":[]}],"summary":"Create a USDT to PIX BRL order"}},"/v1/access/purchase":{"post":{"summary":"Verify BSC USDT payment and issue temporary API access token"}},"/v1/access/quote":{"post":{"summary":"Create a BSC USDT quote for temporary API access"}},"/v1/access/{id}":{"get":{"summary":"Read access quote or grant status"}},"/v1/meter/usage":{"post":{"security":[{"bearerAuth":[]}],"summary":"Debit API usage quota before executing paid work"}},"/webhooks/retry":{"post":{"security":[{"bearerAuth":[]}],"summary":"Retry a webhook for an existing order"}},"/webhooks/test":{"post":{"security":[{"bearerAuth":[]}],"summary":"Generate a simulated webhook payload"}},"/x402/capabilities/{capability}/execute":{"post":{"summary":"Execute a digital capability through HTTP 402 payment challenge and PAYMENT replay"}}},"servers":[{"description":"Production","url":"https://api.chainfx.com"},{"description":"Sandbox","url":"https://sandbox-api.chainfx.com"}],"x-chainfx":{"agentLiquidityRail":["Enabled BSC stablecoin pairs from /agent/v1/assets","USDT/USDC active by default","BUSD registered as legacy disabled asset","6% ChainFX execution fee","on-chain receipt verification","signer-backed treasury settlement","idempotency and nonce-bound intents"],"agentMarketplace":["Capability-first catalog","USDT/USDC on BSC premium API capability purchases","20% default ChainFX take rate","request-bound payment intents","chain_id + tx_hash + log_index receipt verification","quota metering","provider settlement ledger pending manual payout"],"agentPayments":["M2M PIX and credit-card payment intents","agent deposits required USDT to unique payment address","address-based deposit matching","per-agent fee policy","no automatic refund on overpayment"],"category":"Digital FX Payments Infrastructure","notNow":["bridge","pool","AMM","yield","DEX","LP"],"phase":"3","phase2":["Developer Dashboard","API Keys","Logs","Webhook Retry"],"phase3":["Node SDK","Python SDK","OpenAPI","Examples"],"supportedAssets":["USDT"]}}