{"openapi":"3.0.3","info":{"title":"Legendscan API","version":"1","description":"Send x-api-key. Display FDV and catalog quotes are not execution quotes. Holder snapshots and the factory tape are not a complete chain record. POST /api/v1/swap/send broadcasts a signed factory buy or sell."},"servers":[{"url":"https://legendscan.fun"}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key"}}},"paths":{"/api/v1":{"get":{"tags":["Catalog"],"summary":"Route index, buy and sell shapes, and the auth header name.","operationId":"get__api_v1","parameters":[],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/stats":{"get":{"tags":["Catalog"],"summary":"Launchpad counts the site dashboard shows. Display figures, not chain proof.","operationId":"get__api_v1_stats","parameters":[],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/tokens":{"get":{"tags":["Catalog"],"summary":"Catalog tokens with display price, curve fill, and market cap estimate.","operationId":"get__api_v1_tokens","parameters":[],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/tokens/{mint}":{"get":{"tags":["Catalog"],"summary":"One token, its trade lane, and how many holder rows are cached.","operationId":"get__api_v1_tokens__mint_","parameters":[{"name":"mint","in":"path","required":true,"description":"Token mint.","schema":{"type":"string","example":"422DqsfnCANTP7vNToY7hdBaEXPE1qoc6CD9QyDGLGND"}}],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/tokens/{mint}/candles":{"get":{"tags":["Catalog"],"summary":"Display candles. Price and market cap here are not an execution quote.","operationId":"get__api_v1_tokens__mint__candles","parameters":[{"name":"mint","in":"path","required":true,"description":"Token mint.","schema":{"type":"string","example":"422DqsfnCANTP7vNToY7hdBaEXPE1qoc6CD9QyDGLGND"}},{"name":"interval","in":"query","required":false,"description":"1m, 5m, 15m, 1h, 4h, 24h, or 7d. Defaults to 5m.","schema":{"type":"string","example":"5m"}}],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/tokens/board/stream":{"get":{"tags":["Catalog"],"summary":"Server-sent board prices, volume, holders, and trades.","operationId":"get__api_v1_tokens_board_stream","parameters":[],"responses":{"200":{"description":"text/event-stream"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/tokens/{mint}/stream":{"get":{"tags":["Catalog"],"summary":"Server-sent updates for one token while the desk is open.","operationId":"get__api_v1_tokens__mint__stream","parameters":[{"name":"mint","in":"path","required":true,"description":"Token mint.","schema":{"type":"string","example":"422DqsfnCANTP7vNToY7hdBaEXPE1qoc6CD9QyDGLGND"}}],"responses":{"200":{"description":"text/event-stream"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/tokens/{mint}/holders":{"get":{"tags":["Holders"],"summary":"Top holder snapshot. Rows can be tagged Dev, curve, Raydium, rewards, treasury, or LP. This is not a full holder census.","operationId":"get__api_v1_tokens__mint__holders","parameters":[{"name":"mint","in":"path","required":true,"description":"Token mint.","schema":{"type":"string","example":"422DqsfnCANTP7vNToY7hdBaEXPE1qoc6CD9QyDGLGND"}},{"name":"offset","in":"query","required":false,"description":"Page start.","schema":{"type":"string","example":"0"}},{"name":"limit","in":"query","required":false,"description":"Page size.","schema":{"type":"string","example":"25"}}],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/tokens/{mint}/bubble":{"get":{"tags":["Holders"],"summary":"Holder bubble layout from the same snapshot.","operationId":"get__api_v1_tokens__mint__bubble","parameters":[{"name":"mint","in":"path","required":true,"description":"Token mint.","schema":{"type":"string","example":"422DqsfnCANTP7vNToY7hdBaEXPE1qoc6CD9QyDGLGND"}}],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/wallets/{address}":{"get":{"tags":["Holders"],"summary":"Cached wallet profile and the catalog tokens in its holder rows.","operationId":"get__api_v1_wallets__address_","parameters":[{"name":"address","in":"path","required":true,"description":"Wallet address.","schema":{"type":"string","example":"34VX9K3TYE7BgJvMXe3EYnDNUHmLp5rWSLtRyT4SiW5C"}}],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/portfolios":{"get":{"tags":["Holders"],"summary":"Wallets that show up in more than one token holder snapshot.","operationId":"get__api_v1_portfolios","parameters":[{"name":"minTokens","in":"query","required":false,"description":"Minimum catalog tokens. 1 to 20.","schema":{"type":"string","example":"2"}}],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/traders":{"get":{"tags":["Holders"],"summary":"Recent factory traders and the holder-book trader list. Not profit and loss.","operationId":"get__api_v1_traders","parameters":[],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/factory/tape":{"get":{"tags":["Trades"],"summary":"Recent factory buy, sell, launch, and graduation events. Not a complete tape.","operationId":"get__api_v1_factory_tape","parameters":[],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/tokens/{mint}/trades":{"get":{"tags":["Trades"],"summary":"Stored trades for one mint from the three-day cache.","operationId":"get__api_v1_tokens__mint__trades","parameters":[{"name":"mint","in":"path","required":true,"description":"Token mint.","schema":{"type":"string","example":"422DqsfnCANTP7vNToY7hdBaEXPE1qoc6CD9QyDGLGND"}}],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/swap/config":{"get":{"tags":["Swap"],"summary":"Swap desk limits. Display defaults, not a live quote.","operationId":"get__api_v1_swap_config","parameters":[],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/swap/quote":{"get":{"tags":["Swap"],"summary":"Catalog spot estimate for the swap card. Not the curve fill.","operationId":"get__api_v1_swap_quote","parameters":[{"name":"mint","in":"query","required":true,"description":"Token mint.","schema":{"type":"string","example":"422DqsfnCANTP7vNToY7hdBaEXPE1qoc6CD9QyDGLGND"}},{"name":"side","in":"query","required":false,"description":"buy or sell.","schema":{"type":"string","example":"buy"}},{"name":"amountSol","in":"query","required":false,"description":"SOL in for a buy.","schema":{"type":"string","example":"0.05"}},{"name":"amountToken","in":"query","required":false,"description":"Whole tokens for a sell.","schema":{"type":"string","example":"1000000.0"}},{"name":"slippage","in":"query","required":false,"description":"Slippage percent.","schema":{"type":"string","example":"5"}}],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/swap/balances":{"get":{"tags":["Swap"],"summary":"SOL and token balance for a wallet.","operationId":"get__api_v1_swap_balances","parameters":[{"name":"wallet","in":"query","required":true,"description":"Wallet address.","schema":{"type":"string","example":"34VX9K3TYE7BgJvMXe3EYnDNUHmLp5rWSLtRyT4SiW5C"}},{"name":"mint","in":"query","required":true,"description":"Token mint.","schema":{"type":"string","example":"422DqsfnCANTP7vNToY7hdBaEXPE1qoc6CD9QyDGLGND"}}],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}]}},"/api/v1/trade/quote":{"post":{"tags":["Swap"],"summary":"Curve fill for a buy or sell. No wallet and no broadcast.","operationId":"post__api_v1_trade_quote","parameters":[],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"mint":"422DqsfnCANTP7vNToY7hdBaEXPE1qoc6CD9QyDGLGND","side":"buy","amountSol":"0.05","slippage":5}}}}}},"/api/v1/swap/tx":{"post":{"tags":["Swap"],"summary":"Compile the curve fill and return an unsigned packet after simulation.","operationId":"post__api_v1_swap_tx","parameters":[],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"wallet":"34VX9K3TYE7BgJvMXe3EYnDNUHmLp5rWSLtRyT4SiW5C","mint":"422DqsfnCANTP7vNToY7hdBaEXPE1qoc6CD9QyDGLGND","side":"buy","amountSol":"0.05","slippage":5}}}}}},"/api/v1/swap/send":{"post":{"tags":["Swap"],"summary":"Re-simulate a signed factory buy or sell and broadcast it.","operationId":"post__api_v1_swap_send","parameters":[],"responses":{"200":{"description":"JSON"},"401":{"description":"Missing or unknown x-api-key."}},"security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"wireBase64":""}}}}}}}}