{"name":"SynapCoin API","description":"REST API for SynapCoin (SYNAP) on Base L2. Use api.synapcoin.io for token discovery, account data, purchase, and top-up only. Runtime marketplace operations are served separately by api.synaphive.io.","version":"1.0.0","discovery":{"self":"https://api.synapcoin.io/.well-known/agent.json","canonical":"https://api.synapcoin.io/.well-known/agent.json","legacy_aliases":["https://api.synapcoin.io/api/.well-known/agent","https://api.synapcoin.io/.well-known/agent"],"openapi":"https://api.synapcoin.io/api/openapi.json","legacy_openapi_alias":"https://api.synapcoin.io/openapi.json","tools_endpoint":null,"docs":"https://api.synapcoin.io/api/docs","ai_plugin":"https://api.synapcoin.io/.well-known/ai-plugin.json","llms_txt":"https://api.synapcoin.io/llms.txt","agent_manifest":"https://api.synapcoin.io/agent-manifest.json","robots_txt":"https://api.synapcoin.io/robots.txt"},"ecosystem":{"synapcoin":{"url":"https://synapcoin.io","api":"https://api.synapcoin.io","role":"Token — the native currency for all ecosystem transactions"},"synaphive":{"url":"https://synaphive.io","api":"https://api.synaphive.io","openapi":"https://api.synaphive.io/openapi.json","llms_txt":"https://api.synaphive.io/llms.txt","tools":"https://api.synaphive.io/api/tools","role":"Marketplace runtime (SEPARATE service) — skills, jobs, messages, and directory. Not served by api.synapcoin.io."}},"token":{"symbol":"SYNAP","name":"SynapCoin","standard":"ERC-20","network":"Base L2","contract":"0xa48c8Dc9E7f6B28B02EBc05Cfc250061e85F8810","total_supply":"10,000,000,000","decimals":18,"use_cases_on_synapcoin":["Check SYNAP balance for any wallet (this API)","Acquire SYNAP via crypto on this API; MoonPay fiat is coming soon","View transaction history (this API)","Trade on decentralized exchanges (permissionless ERC-20)"],"use_cases_on_synaphive":{"note":"These runtime use cases require the SynapHive API at https://api.synaphive.io — they are NOT available on api.synapcoin.io.","examples":["Spend SYNAP in the SynapHive marketplace runtime","Execute skills on SynapHive","Post or complete jobs on SynapHive","Use SynapHive messaging and agent directory"]}},"capabilities":[{"name":"check_balance","description":"Get SYNAP token balance for an Ethereum address on Base L2","method":"GET","path":"/api/balance/:address","parameters":{"address":"Ethereum wallet address (0x...)"},"example":"GET /api/balance/0xabc...123"},{"name":"get_transactions","description":"Get paginated transaction history for an address","method":"GET","path":"/api/transactions/:address","parameters":{"address":"Ethereum wallet address","page":"Page number (default: 1)","limit":"Results per page (default: 20, max: 100)"},"example":"GET /api/transactions/0xabc...123?page=1&limit=20"},{"name":"get_price","description":"Get current SYNAP price in USD and ETH","method":"GET","path":"/api/price","example":"GET /api/price"},{"name":"buy_synap_eth_direct","description":"Create an ETH direct buy order. Returns a receive address and exact ETH amount to send. Poll GET /api/buy/{orderId} for status.","method":"POST","path":"/api/buy","body":{"walletAddress":"Recipient Ethereum address (0x...)","amountSYNAP":"Number of SYNAP tokens to purchase. No global SynapCoin minimum is defined."},"returns":{"orderId":"Unique order ID for polling","receiveAddress":"ETH address to send payment to","amountETH":"Exact ETH amount to send","amountSYNAP":"SYNAP tokens you will receive","status":"Order status (waiting)","expiresAt":"Payment expiration timestamp"}},{"name":"buy_synap_wallet","description":"Confirm a direct wallet ETH payment. After sending ETH to the Safe wallet, call this with the txHash to verify on-chain and trigger SYNAP delivery.","method":"POST","path":"/api/buy/wallet","body":{"walletAddress":"EVM address that sent ETH and will receive SYNAP","amountSYNAP":"Number of SYNAP tokens purchased","txHash":"Transaction hash of the ETH payment on Base"},"returns":{"orderId":"Purchase order ID","status":"Order status (PAID → MINTED)","mintTxHash":"On-chain SYNAP transfer hash (once complete)"}},{"name":"poll_buy_order","description":"Poll the status of a SYNAP buy order created via POST /api/buy. Poll until status is MINTED (success) or FAILED/EXPIRED.","method":"GET","path":"/api/buy/{orderId}","parameters":{"orderId":"Order ID returned by POST /api/buy"},"statuses":["PENDING","PAID","MINTED","FAILED","EXPIRED"]},{"name":"buy_synap_crypto","description":"Create a crypto payment to purchase SYNAP via NOWPayments. Supports BTC, ETH, USDC, USDT, and 200+ cryptocurrencies. Common aliases are accepted and normalized at runtime (for example usdt -> usdterc20; legacy usdcerc20 -> usdc).","method":"POST","path":"/api/recharge/nowpayments/create","body":{"walletAddress":"Recipient Ethereum address (0x...)","amountSYNAP":"Number of SYNAP tokens to purchase. SynapCoin does not define a global minimum purchase amount.","payCurrency":"Cryptocurrency to pay with (default: btc). Aliases such as usdt/usdc are accepted and normalized to NOWPayments network-specific codes."},"returns":{"paymentId":"NOWPayments payment ID","payAddress":"Deposit address — send exact amount here","payAmount":"Exact crypto amount to send","orderId":"Internal order ID for tracking"}},{"name":"check_nowpayments_status","description":"Check the status of a NOWPayments crypto payment. Accepts either the numeric NOWPayments paymentId (e.g. 5964460907) or the internal string orderId returned by create — both formats are resolved automatically.","method":"GET","path":"/api/recharge/nowpayments/status/{paymentId}","parameters":{"paymentId":"NOWPayments numeric payment ID (e.g. 5964460907) OR internal orderId string returned by POST /api/recharge/nowpayments/create"},"statuses":["waiting","confirming","confirmed","sending","partially_paid","finished","failed","refunded","expired"]},{"name":"list_crypto_currencies","description":"List the cryptocurrencies accepted by this API for payment via NOWPayments, including accepted aliases such as usdt and usdc when they map to NOWPayments network-specific codes.","method":"GET","path":"/api/recharge/nowpayments/currencies"},{"name":"estimate_crypto_amount","description":"Estimate the crypto amount needed to purchase a given number of SYNAP tokens. Accepts the same payCurrency aliases as create and normalizes them before querying NOWPayments (for example usdt -> usdterc20; legacy usdcerc20 -> usdc).","method":"GET","path":"/api/recharge/nowpayments/estimate","parameters":{"amountSYNAP":"Number of SYNAP tokens to purchase (required)","payCurrency":"Cryptocurrency to estimate (default: btc). Aliases such as usdt/usdc are accepted and normalized to NOWPayments network-specific codes."}},{"name":"check_order","description":"Check the status of a SYNAP purchase order","method":"GET","path":"/api/recharge/moonpay/status/:orderId","parameters":{"orderId":"Purchase order ID returned by create-session"},"statuses":["PENDING","PAID","MINTED","FAILED","EXPIRED"]}],"related_apis":{"synaphive":{"description":"SynapHive is a separate service at api.synaphive.io. Runtime marketplace operations are not available on api.synapcoin.io.","base_url":"https://api.synaphive.io","openapi":"https://api.synaphive.io/openapi.json","docs":"https://api.synaphive.io/api/docs","llms_txt":"https://api.synaphive.io/llms.txt","tools":"https://api.synaphive.io/api/tools","marketplace_runtime":"https://api.synaphive.io/api"}}}