{"openapi":"3.1.0","info":{"title":"Agora API","version":"1.0.0","description":"Every coin, trade and wallet on every Elysium launchpad, and the best swap across all of them. Free: get a key at https://developers.agoradex.app."},"servers":[{"url":"https://www.agoradex.app/api/v1"}],"components":{"securitySchemes":{"key":{"type":"apiKey","in":"header","name":"x-api-key"}}},"security":[{"key":[]},{}],"paths":{"/tokens":{"get":{"operationId":"list-tokens","tags":["Tokens"],"summary":"List tokens","description":"Every coin from every Elysium launchpad Agora aggregates, with price, market cap (HYPE and USD), change, volume, links and pool keys. Search, filter by launchpad, sort and page through them.","parameters":[{"name":"q","in":"query","required":false,"description":"Search by name, symbol or address.","schema":{"type":"string"}},{"name":"launchpad","in":"query","required":false,"description":"Only this launchpad's coins (an id from /launchpads).","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"Order.","schema":{"type":"string","enum":["volume","mcap","new","gainers","trades","trending"],"default":"volume"}},{"name":"window","in":"query","required":false,"description":"The window volume, gainers and trades sort by.","schema":{"type":"string","enum":["1h","6h","24h","7d"],"default":"24h"}},{"name":"limit","in":"query","required":false,"description":"Results per page, at most 100.","schema":{"type":"integer","default":"50"},"example":"5"},{"name":"offset","in":"query","required":false,"description":"Skip this many (paging).","schema":{"type":"integer","default":"0"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"tokens":[{"address":"0xd662…cf38","name":"CHAMELEON","symbol":"CHAMELEON","image":"https://www.agoradex.app/api/img?src=…","launchpad":"montra","base":"HYPE","verified":false,"tradable":true,"createdAt":"2026-11-05T03:14:39.000Z","priceBase":0.0000207,"priceHype":0.0000207,"priceUsd":0.00161,"marketCapHype":20729.5,"marketCapUsd":1610116,"change":{"1h":0.67,"6h":7.16,"24h":2.12,"7d":436.6},"volumeHype":{"1h":758.9,"6h":2606.2,"24h":7382.7,"7d":12028.1},"trades24h":1819,"buys24h":1099,"lastTradeAt":"2026-11-06T06:39:39.000Z","url":"https://www.agoradex.app/token/0xd662…cf38","creator":"0x…","links":{"website":null,"x":"https://x.com/…","telegram":null},"pools":[{"venue":"Montra","pool":"0x61a7…aac"}]}],"total":8123,"limit":5,"offset":0}}}},"4XX":{"description":"{ error: { code, message } }"}}}},"/tokens/{address}":{"get":{"operationId":"get-token","tags":["Tokens"],"summary":"Get a token","description":"One coin: everything in the list, plus its creator, description, links, holder count, tax and the pools it trades in.","parameters":[{"name":"address","in":"path","required":true,"description":"The coin's contract address.","schema":{"type":"string"},"example":"0xd662d66ec991a3eae4ecbda34327264c53d4cf38"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"address":"0xd662…cf38","symbol":"CHAMELEON","priceHype":0.0000207,"creator":"0x…","description":"…","links":{"website":null,"x":"…","telegram":null},"holders":395,"tax":null,"pools":[{"venue":"Montra","pool":"0x61a7…aac"}]}}}},"4XX":{"description":"{ error: { code, message } }"}}}},"/tokens/{address}/candles":{"get":{"operationId":"candles","tags":["Tokens"],"summary":"Price candles","description":"OHLC candles in the coin's base (HYPE or KNTQ), with volume. Pick a candle size with `interval` (1s to 1d), or a time span with `range`.","parameters":[{"name":"address","in":"path","required":true,"description":"The coin's contract address.","schema":{"type":"string"},"example":"0xd662d66ec991a3eae4ecbda34327264c53d4cf38"},{"name":"interval","in":"query","required":false,"description":"Candle size. History: 1s: 15 min, 1m: 8 h, 5m: 2 days, 15m: 5 days, 1h: 20 days, 4h: 80 days, 1d: since launch.","schema":{"type":"string","enum":["1s","1m","5m","15m","1h","4h","1d"]}},{"name":"range","in":"query","required":false,"description":"Used when interval is not set: how far back, with a fitting candle size.","schema":{"type":"string","enum":["1h","24h","7d","all"],"default":"24h"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"address":"0xd662…cf38","base":"HYPE","range":"24h","candles":[{"time":"2026-11-05T06:30:00.000Z","open":0.00000663,"high":0.00000664,"low":0.00000648,"close":0.00000648,"volumeBase":6.57}]}}}},"4XX":{"description":"{ error: { code, message } }"}}}},"/tokens/{address}/trades":{"get":{"operationId":"token-trades","tags":["Tokens"],"summary":"Recent trades","description":"The coin's latest trades on every venue, newest first. `kind` marks arbitrage bots and $AGORA buyback burns.","parameters":[{"name":"address","in":"path","required":true,"description":"The coin's contract address.","schema":{"type":"string"},"example":"0xd662d66ec991a3eae4ecbda34327264c53d4cf38"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"address":"0xd662…cf38","base":"HYPE","trades":[{"time":"2026-11-06T06:39:39.000Z","side":"sell","priceBase":0.0000207,"amountBase":10.61,"wallet":"0x…","tx":"0xee70…b8ee"}]}}}},"4XX":{"description":"{ error: { code, message } }"}}}},"/tokens/{address}/holders":{"get":{"operationId":"holders","tags":["Tokens"],"summary":"Top holders","description":"The coin's largest holders with their share of supply, value, cost basis and P&L (in the coin's base).","parameters":[{"name":"address","in":"path","required":true,"description":"The coin's contract address.","schema":{"type":"string"},"example":"0xd662d66ec991a3eae4ecbda34327264c53d4cf38"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"address":"0xd662…cf38","count":395,"updatedAt":"2026-11-06T06:39:48.976Z","holders":[{"wallet":"0xe2e1…23f1","amount":45157953.3,"shareOfSupply":0.045,"valueBase":936.1,"costBase":512.4,"realizedBase":0,"unrealizedBase":423.7,"pnlBase":423.7,"pnlPct":0.83}]}}}},"4XX":{"description":"{ error: { code, message } }"}}}},"/tokens/{address}/bubbles":{"get":{"operationId":"bubbles","tags":["Tokens"],"summary":"Bubble map","description":"Who holds the coin and how those holders are connected. `nodes` are the top holders (tag: pool, burn, launchpad, or linker for a non-holder wallet that moved the coin between 2+ holders, such as a funder or bundler). `links` are transfers of the coin between them, and `clusters` are groups connected that way (often one owner, a bundle or a team). If `complete` is false, history is still being read, so call again in a few seconds.","parameters":[{"name":"address","in":"path","required":true,"description":"The coin's contract address.","schema":{"type":"string"},"example":"0xd662d66ec991a3eae4ecbda34327264c53d4cf38"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"address":"0xd662…cf38","complete":true,"progress":1,"nodes":[{"wallet":"0xe2e1…23f1","amount":48484698.7,"shareOfSupply":0.0485,"tag":"pool","cluster":null},{"wallet":"0x710d…d021","amount":21000000,"shareOfSupply":0.021,"tag":null,"cluster":1}],"links":[{"from":"0x710d…d021","to":"0x99f2…6a25","transfers":1,"amount":10000000}],"clusters":[{"id":1,"wallets":2,"shareOfSupply":0.0364}]}}}},"4XX":{"description":"{ error: { code, message } }"}}}},"/wallets/{address}":{"get":{"operationId":"wallet","tags":["Wallets"],"summary":"Wallet portfolio","description":"A wallet's coins with value, cost and P&L in HYPE, its HYPE balance, and its trading totals.","parameters":[{"name":"address","in":"path","required":true,"description":"The wallet address.","schema":{"type":"string"},"example":"0xe2e105d3f7209a9da11f83ccf3e7398a753823f1"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"address":"0xe2e1…23f1","isContract":false,"hypeBalance":12.4,"hypeUsd":77.6,"totals":{"worthHype":20.68,"pnlHype":4.92,"realizedHype":6.96,"unrealizedHype":-2.04,"volumeHype":15.39,"trades":29,"buys":23,"sells":6,"firstSeen":"…","lastActive":"…"},"holdings":[{"token":"0x7a7a…c60b","symbol":"ELYSP","launchpad":"elyspump","amount":6016106.5,"shareOfSupply":0.006,"valueHype":20.68,"costHype":22.7,"pnlHype":-2.04}]}}}},"4XX":{"description":"{ error: { code, message } }"}}}},"/wallets/{address}/trades":{"get":{"operationId":"wallet-trades","tags":["Wallets"],"summary":"Wallet trades","description":"A wallet's latest 100 trades across every launchpad, newest first.","parameters":[{"name":"address","in":"path","required":true,"description":"The wallet address.","schema":{"type":"string"},"example":"0xe2e105d3f7209a9da11f83ccf3e7398a753823f1"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"address":"0xe2e1…23f1","trades":[{"time":"2026-11-03T15:28:09.000Z","token":"0x7a7a…c60b","symbol":"ELYSP","side":"buy","amount":144.01,"amountBase":0.00056,"base":"HYPE","tx":"0xb4dc…"}]}}}},"4XX":{"description":"{ error: { code, message } }"}}}},"/quote":{"get":{"operationId":"quote","tags":["Trading"],"summary":"Quote & build a swap","description":"The best price for a buy or sell across every launchpad and DEX (or coin to coin with `payToken`), and, with `recipient`, the ready-to-sign transaction. Swaps go through AgoraRouter: pass your builder code as `ref` and you earn 30% of Agora's fee on every trade (your users get 10% off). Send any `approvals` first, then `transaction`. Also accepts POST with a JSON body.","parameters":[{"name":"token","in":"query","required":true,"description":"The coin to buy or sell.","schema":{"type":"string"},"example":"0xd662d66ec991a3eae4ecbda34327264c53d4cf38"},{"name":"side","in":"query","required":true,"description":"buy: spend HYPE. sell: sell the coin for HYPE.","schema":{"type":"string","enum":["buy","sell"]},"example":"buy"},{"name":"amount","in":"query","required":true,"description":"HYPE to spend (buy) or coins to sell (sell), as a decimal.","schema":{"type":"string"},"example":"0.1"},{"name":"recipient","in":"query","required":false,"description":"The trader's wallet. Needed to get a transaction (and for the fee: $AGORA holders pay none).","schema":{"type":"string"}},{"name":"ref","in":"query","required":false,"description":"Your builder code (claim one in the Dashboard).","schema":{"type":"string"}},{"name":"slippageBps","in":"query","required":false,"description":"Max slippage in basis points, 10 to 5000.","schema":{"type":"integer","default":"100"}},{"name":"pay","in":"query","required":false,"description":"KNTQ-paired coins: HYPE to trade them with HYPE (routed through KNTQ).","schema":{"type":"string","enum":["KNTQ","HYPE"]}},{"name":"payToken","in":"query","required":false,"description":"Coin to coin: pay with this coin instead of HYPE (amount is in this coin; side is ignored). One transaction through AgoraHop: sells it for HYPE, buys token. Builder codes don't earn on coin-to-coin swaps.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"token":"0xd662…cf38","side":"buy","amountIn":"100000000000000000","amountOut":"4765264362342729945029","minAmountOut":"4717611718719302645578","venue":"Montra","priceImpact":0.0102,"feeBps":100,"builderCode":"yourapp","venues":[{"venue":"Montra","amountOut":"4765264362342729945029"}],"approvals":[],"transaction":{"to":"0xaf8d…a295","data":"0x07d9…","value":"100000000000000000","chainId":99901}}}}},"4XX":{"description":"{ error: { code, message } }"}}}},"/launchpads":{"get":{"operationId":"launchpads","tags":["Launchpads"],"summary":"List launchpads","description":"Every launchpad Agora aggregates: its id (for the tokens filter), name, site, X account, logo and number of coins.","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"launchpads":[{"id":"boxa","name":"BOXA","site":"https://boxa.club","x":"https://x.com/Boxa_Elysium","logo":"https://www.agoradex.app/launchpads/boxa.jpg","tokens":4548}],"otherTokens":12}}}},"4XX":{"description":"{ error: { code, message } }"}}}}}}