Legendscan

API Access

JSON for integrators. Send x-api-key on every call. The spec is at /api/openapi.

Request an API token

How to call the API

Send x-api-key on every request. Pages on this site can call the API without that header. The tester below cannot.

curl -s https://legendscan.fun/api/v1/tokens \
  -H 'accept: application/json' \
  -H 'x-api-key: YOUR_TOKEN'

Price a curve buy or sell with POST /api/v1/trade/quote. That quote does not broadcast. POST /api/v1/swap/tx returns an unsigned packet. POST /api/v1/swap/send broadcasts a signed factory buy or sell. Display prices and FDV are not execution quotes. Holder rows are a top snapshot. The factory tape is recent events, not a full chain history. The machine-readable spec is /api/openapi.

Catalog

  • GET /api/v1Route index, buy and sell shapes, and the auth header name.
  • GET /api/v1/statsLaunchpad counts the site dashboard shows. Display figures, not chain proof.
  • GET /api/v1/tokensCatalog tokens with display price, curve fill, and market cap estimate.
  • GET /api/v1/tokens/{mint}One token, its trade lane, and how many holder rows are cached.
  • GET /api/v1/tokens/{mint}/candlesDisplay candles. Price and market cap here are not an execution quote.
  • GET /api/v1/tokens/board/streamServer-sent board prices, volume, holders, and trades.
  • GET /api/v1/tokens/{mint}/streamServer-sent updates for one token while the desk is open.

Holders

  • GET /api/v1/tokens/{mint}/holdersTop holder snapshot. Rows can be tagged Dev, curve, Raydium, rewards, treasury, or LP. This is not a full holder census.
  • GET /api/v1/tokens/{mint}/bubbleHolder bubble layout from the same snapshot.
  • GET /api/v1/wallets/{address}Cached wallet profile and the catalog tokens in its holder rows.
  • GET /api/v1/portfoliosWallets that show up in more than one token holder snapshot.
  • GET /api/v1/tradersRecent factory traders and the holder-book trader list. Not profit and loss.

Trades

  • GET /api/v1/factory/tapeRecent factory buy, sell, launch, and graduation events. Not a complete tape.
  • GET /api/v1/tokens/{mint}/tradesStored trades for one mint from the three-day cache.

Swap

  • GET /api/v1/swap/configSwap desk limits. Display defaults, not a live quote.
  • GET /api/v1/swap/quoteCatalog spot estimate for the swap card. Not the curve fill.
  • GET /api/v1/swap/balancesSOL and token balance for a wallet.
  • POST /api/v1/trade/quoteCurve fill for a buy or sell. No wallet and no broadcast.
  • POST /api/v1/swap/txCompile the curve fill and return an unsigned packet after simulation.
  • POST /api/v1/swap/sendRe-simulate a signed factory buy or sell and broadcast it.

Every call from this tester sends x-api-key. A missing or unknown token returns 401. Display prices are not execution quotes. Send broadcasts a signed factory buy or sell.

GET/api/v1Route index, buy and sell shapes, and the auth header name.
GET/api/v1/statsLaunchpad counts the site dashboard shows. Display figures, not chain proof.
GET/api/v1/tokensCatalog tokens with display price, curve fill, and market cap estimate.
GET/api/v1/tokens/{mint}One token, its trade lane, and how many holder rows are cached.
GET/api/v1/tokens/{mint}/candlesDisplay candles. Price and market cap here are not an execution quote.
GET/api/v1/tokens/board/streamServer-sent board prices, volume, holders, and trades.
GET/api/v1/tokens/{mint}/streamServer-sent updates for one token while the desk is open.
GET/api/v1/tokens/{mint}/holdersTop holder snapshot. Rows can be tagged Dev, curve, Raydium, rewards, treasury, or LP. This is not a full holder census.
GET/api/v1/tokens/{mint}/bubbleHolder bubble layout from the same snapshot.
GET/api/v1/wallets/{address}Cached wallet profile and the catalog tokens in its holder rows.
GET/api/v1/portfoliosWallets that show up in more than one token holder snapshot.
GET/api/v1/tradersRecent factory traders and the holder-book trader list. Not profit and loss.
GET/api/v1/factory/tapeRecent factory buy, sell, launch, and graduation events. Not a complete tape.
GET/api/v1/tokens/{mint}/tradesStored trades for one mint from the three-day cache.
GET/api/v1/swap/configSwap desk limits. Display defaults, not a live quote.
GET/api/v1/swap/quoteCatalog spot estimate for the swap card. Not the curve fill.
GET/api/v1/swap/balancesSOL and token balance for a wallet.
POST/api/v1/trade/quoteCurve fill for a buy or sell. No wallet and no broadcast.
POST/api/v1/swap/txCompile the curve fill and return an unsigned packet after simulation.
POST/api/v1/swap/sendRe-simulate a signed factory buy or sell and broadcast it.