ScoutraBeta
Docs / API

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.