{"schemaVersion":"2.0.0","name":"BT365 Agent API","description":"Agent-native trading API for BT365 DEX aggregator. Supports server-side swap execution (recommended for bots) and unsigned transaction building.","logo":"https://bt365.ai/logo.png","website":"https://bt365.ai","documentation":"https://bt365.ai/api/v1/doc-json","capabilities":{"quote":true,"swap":true,"swapExecution":true,"points":true,"reputation":true,"tokenLaunch":true,"agentCreation":true},"chains":[{"chainId":8453,"name":"Base","rpc":"https://mainnet.base.org"}],"tokens":{"base":["0x4200000000000000000000000000000000000006","0x768be13e1680b5ebe0024c42c896e3db59ec0149","0x4f9fd6be4a90f2620860d680c0d4d5fb53d1a825","0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b","0x696f9436b67233384889472cd7cd58a6fb5df4f1","0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","0xef22cb48b8483df6152e1423b19df5553bbd818b","0xf30bf00edd0c22db54c9274b90d2a4c21fc09b07","0x7d928816cc9c462dd7adef911de41535e444cb07","0x1f015712aa2a48085ec93f87d643bb625b668b07","0xc0634090f2fe6c6d75e61be2b949464abb498973","0x79bbf4508b1391af3a0f4b30bb5fc4aa9ab0e07c","0x9f86db9fc6f7c9408e8fda3ff8ce4e78ac7a6b07","0x940181a94a35a4569e4529a3cdfb74e38fd98631","0x22af33fe49fd1fa80c7149773dde5890d3c76f3b","0x767a739d1a152639e9ea1d8c1bd55fdc5b217d7f","0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf","0xecaf81eb42cd30014eb44130b89bcd6d4ad98b92","0xb200000000000000000000b1a29cf17a1819288a","0xb2000000000000000000007b9fcbd005511acbd5","0xb2000000000000000000008bc8786b856e61707c","0xb200000000000000000000ab99cfa739e253872b","0xb200000000000000000000c2e324d24d7eecd1fb","0xb2000000000000000000002d0ba3164cc74f58b7","0xb20000000000000000000043a599976181bcf336","0xb20000000000000000000078ee7ce2fe4908108c","0xb200000000000000000000d9192b6b456483c2e8","0x50d2280441372486beecdd328c1854743ebacb07","0x1111111111166b7fe7bd91427724b487980afc69","0xb20000000000000000000017bb66e9301e913a99","0xb200000000000000000000187f7071d6e321a7d2","0xb2000000000000000000001e800a7f5189430cd0","0xb2000000000000000000003088798f6d0722aaac","0xb200000000000000000000347afba223d7b6b63c","0xb200000000000000000000349ef3aa93a0897476","0xb200000000000000000000397293cb8cda9a10c5","0xb2000000000000000000004884b426556b92883d","0xb20000000000000000000058b8c947e44011dfe6","0xb20000000000000000000063376b142c0764b489","0xb2000000000000000000007d16372840df4dabbe","0xb2000000000000000000008d5328e9208773dc58","0xb200000000000000000000a26326a922ffa87f6c","0xb200000000000000000000c36ce081dd09e86ca2","0xb200000000000000000000c8a7223510467d8563","0xb200000000000000000000ca425ab42e07c35bc3","0xb200000000000000000000ca7c6d1438e7245eb6","0xb200000000000000000000d2b7d9aee52f6c6bef","0xb20000000000000000000026215d755356e5043f","0xb200000000000000000000d61efd9f54a23ef9eb","0xb200000000000000000000da6f64c306234127e0","0xb200000000000000000000e88efe88d8ade3f0da","0xb200000000000000000000f3049f4aa834b23b64","0xb200000000000000000000f6b0417af5f52341fc","0xb200000000000000000000fc737aea6196ab5a4c","0xb200000000000000000000fd2f87532b90095211","0xb2000000000000000000002d2b5dc53c61f1ba06","0xb2000000000000000000007790ed6e48e06ed935","0xb2000000000000000000005ac674f707e357409c","0x3722264ab15a1dfce5a5af89e6547f7949a8aba3","0x2b5050f01d64fbb3e4ac44dc07f0732bfb5ecadf","0xa4a2e2ca3fbfe21aed83471d28b6f65a233c6e00","0x706e1963ba410a548673b46d694104391fb7dca5","0xb2000000000000000000004c27f6523082f41d01","0x5b5dee44552546ecea05edea01dcd7be7aa6144a","0x6b2504a03ca4d43d0d73776f6ad46dab2f2a4cfd","0xc0041ef357b183448b235a8ea73ce4e4ec8c265f","0x65021a79aeef22b17cdc1b768f5e79a8618beba3","0x9cb41fd9dc6891bae8187029461bfaadf6cc0c69","0x1bc0c42215582d5a085795f4badbac3ff36d1bcb","0x7b0ee9dcb5c1d4d7cd630c652959951936512ba3","0x2efac0a597a37050aafcf4bec627249d533dd9f8","0xac1bd2486aaf3b5c0fc3fd868558b082a531b2b4","0x3ec2156d4c0a9cbdab4a016633b7bcf6a8d68ea2","0x4ed4e862860bed51a9570b96d89af5e1b0efefed","0x2d57c47bc5d2432feeedf2c9150162a9862d3ccf","0xdb6e0e5094a25a052ab6845a9f1e486b9a9b3dde","0x6921b130d297cc43754afba22e5eac0fbf8db75b","0x96419929d7949d6a801a6909c145c8eef6a40431","0x9a26f5433671751c3276a065f57e5a02d2817973","0xb233bdffd437e60fa451f62c6c09d3804d285ba3"]},"authentication":{"modes":[{"type":"api-key","description":"MCP API Key mode - server holds wallet and executes swaps for you. Best for bots.","recommended":true,"headerName":"X-API-Key","headerFormat":"bt365_...","setup":["1. Generate API key via POST /api/v1/agent-api/mcp/keys (requires Privy auth)","2. Fund server wallet with ETH + tokens (address returned in key response)","3. Execute swaps via POST /api/v1/agent-api/swap/execute","4. Points are automatically indexed"]}]},"swapContracts":{"description":"BT365 uses custom swap helper contracts that collect fees. Approve tokens to THESE addresses, not DEX routers.","feePercent":"0.35%","feePayment":"ETH sent as msg.value (returned in unsigned transaction value field)","contracts":{"UNISWAP_V2":"0x198e9841672223ECBBbef10268faE9026439a063","UNISWAP_V3":"0x03ef6b3474409b6DB4BeBa3d77D2A9F073580961","UNISWAP_V4":"0xF92d7296c440e722334fA94fef00253c72466413","AERODROME_V2":"0x35267174E4F42e185982d84088ecB2CD90F78990","AERODROME_V3":"0xAf1F3Dc4dC6dD98631c7E66cb3aDd1e04A4e70Ff","AERODROME_V3_GV3":"0x3137A4A8fC477234203AA1117dF3CfAc320AeBC5"}},"endpoints":{"swapExecute":{"method":"POST","path":"/api/v1/agent-api/swap/execute","description":"Execute swap via server wallet (RECOMMENDED FOR BOTS). Server signs and submits transaction. Points auto-indexed.","auth":"api-key","headers":{"X-API-Key":"bt365_..."},"body":{"tokenIn":"string (address)","tokenOut":"string (address)","amountIn":"string (wei)","slippageBps":"number? (default: 100 = 1%)","chainId":"number? (default: 8453)"},"response":{"txHash":"string","amountOut":"string","protocol":"string","explorerUrl":"string"}},"mcpBalance":{"method":"GET","path":"/api/v1/agent-api/mcp/balance","description":"Get server wallet balances (ETH, USDC, WETH)","auth":"api-key","headers":{"X-API-Key":"bt365_..."},"params":["chainId?"]},"mcpWallet":{"method":"GET","path":"/api/v1/agent-api/mcp/wallet","description":"Get server wallet address for deposits","auth":"api-key","headers":{"X-API-Key":"bt365_..."}},"generateApiKey":{"method":"POST","path":"/api/v1/agent-api/mcp/keys","description":"Generate new MCP API key (one-time setup)","auth":"privy","body":{"name":"string"},"response":{"apiKey":"string (save this - shown once only)","keyId":"string","serverWalletAddress":"string (fund this address)"}},"listApiKeys":{"method":"GET","path":"/api/v1/agent-api/mcp/keys","description":"List your MCP API keys","auth":"privy"},"revokeApiKey":{"method":"DELETE","path":"/api/v1/agent-api/mcp/keys/:id","description":"Revoke an MCP API key","auth":"privy"},"leaderboard":{"method":"GET","path":"/api/v1/agent-api/leaderboard","description":"Get points leaderboard (FREE)","auth":"none","params":["limit?","offset?"]},"reputation":{"method":"GET","path":"/api/v1/agent-api/reputation/:agentAddress","description":"Get agent reputation score (FREE)","auth":"none"},"registerAgent":{"method":"POST","path":"/api/v1/agent-api/register","description":"Register external agent via wallet signature (no Privy required). Returns API key once.","auth":"none","body":{"name":"string (1-64 chars)","wallet":"string (0x EVM address)","signature":"string (EIP-191 personal_sign)","timestamp":"number (unix seconds, ±5 min window)"},"messageFormat":"Register agent {name} on BT365\nWallet: {wallet}\nTimestamp: {timestamp}"},"submitFeedback":{"method":"POST","path":"/api/v1/agent-api/reputation/feedback","description":"Submit reputation feedback for an agent","auth":"privy","body":{"agentAddress":"string","positive":"boolean","swapTxHash":"string","comment":"string?"}},"getAgent":{"method":"GET","path":"/api/v1/agent-api/agents/:id","description":"Get agent status and details (FREE)","auth":"none"},"getTemplates":{"method":"GET","path":"/api/v1/agent-api/templates","description":"List available agent templates (FREE)","auth":"none"},"getDeployer":{"method":"GET","path":"/api/v1/agent-api/tokens/deployer","description":"Get deployer address for ETH payments (FREE)","auth":"none"},"recentTokens":{"method":"GET","path":"/api/v1/agent-api/tokens/recent","description":"Get recently launched tokens (FREE)","auth":"none","params":["limit?"]}},"pointsSystem":{"baseRate":"1 point per $1 USD volume","multipliers":{"bt365Pairs":2,"registeredAgents":1.2},"bt365Token":"0x706E1963bA410A548673b46D694104391fB7dCA5"},"reputationRegistry":{"type":"erc8004","chainId":8453,"agentRegistryAddress":"0xD4A634949D540A5b44E32cd78509cD49C32d7b42","reputationRegistryAddress":null},"errors":{"format":"{ statusCode: number, error: string, message: string }","commonCodes":{"400":"Bad Request - Invalid parameters or insufficient balance","401":"Unauthorized - Missing or invalid API key / Privy auth","404":"Not Found - No route found for swap, token not found","429":"Too Many Requests - Rate limit exceeded","500":"Internal Server Error - Contact support"}},"contact":{"twitter":"@BlockTrader365","support":"business@blocktrader365.com"}}