Public API
These are the GET endpoints the app itself calls. They are public and read-only, have no API key and no uptime promise, and their shapes can change without notice. Please cache and don't hammer them.
Chain and market
GET /api/net- Latest block and network status.
GET /api/health- Server and data-source health.
GET /api/trending- Most traded tokens and stock tokens in the recent window, with swap counts and volume.
GET /api/market?token=0x…- Pools and price data for one token.
GET /api/stockmarket- Stock tokens, their pools and venues.
GET /api/whales?min=- Largest recent swaps and the wallets that made them.
GET /api/logo?a=0x…- Token logo (or a generated placeholder).
Launches and checks
GET /api/radar?limit=- Newest pools with their creators.
GET /api/launches- New pools per hour (v2 / v4).
GET /api/pads/brief- Counts of launches today, by launchpad.
GET /api/check/token?q=0x…- Token check: simulated buy and sell, tax, owner, liquidity, creator, ticker.
GET /api/check/holders?token=0x…- Top holders of a token.
GET /api/check/research?token=0x…- Links from the token's public listing, whether its site and repo respond, and the creator's record.
GET /api/check/radar · /api/check/launches · /api/check/pads- Data behind the Radar and Launch analytics pages.
GET /api/token?q=- Look up a token by address or ticker.
Trade
Quotes are read-only. Building a swap transaction is a POST that needs sign-in; the transaction is unsigned and your wallet signs it.
GET /api/trade/quote?from=&to=&amount=- Every Uniswap v2 / v3 / v4 route quoted at the latest block.
GET /api/trade/market?token=0x…- Chart and depth data for the terminal.
GET /api/trade/swaps?token=0x…&w=- Recent swaps in a token's pool, priced in USD.
GET /api/trade/balance?token=0x…&address=0x…- One public token balance.
Pools and wallets
GET /api/earn- Pools with a fee history.
GET /api/account/pools- Pools with hourly volume and impermanent-loss estimates.
GET /api/account/lp?address=0x…- Liquidity positions of an address.
GET /api/account/transparency- Project contracts and their status (all planned, none deployed).
GET /api/wallet?address=0x…- Everything an address holds at the latest block.
GET /api/wallet/trail?address=0x…- What recent token transfers reveal about an address (counterparties, swaps, tokens).
GET /api/wallet/share?address=0x…&hours=- Creates an expiring share token (holdings only, no address).
Agents (preview) and AI
Agent endpoints run our rule engine on live pools; nothing is sent on chain. Log and mandate data are demo and say so with demo: true.
GET /api/agents/guard?token=0x…&side=&amount=- Quote and simulated trade, then the rule gate. Nothing is sent.
GET /api/agents/break?s=- Run one attack scenario through the rule engine.
GET /api/agents/history- Daily ETH prices from on-chain swaps, for stress tests.
GET /api/agents/log · /api/agents/registry · /api/mandate- Demo decision log and an empty registry (no contract).
GET /api/predict- Always empty: no prediction contract exists.
GET /api/compute?what=models- AI model catalogue with prices.
GET /api/compute?what=gpus- GPU price table (demo).
Responses
Responses are JSON. While a data source is still loading, an endpoint can answer with warming: true and partial data; try again a little later. Demo data carries demo: true.