> ## Documentation Index > Fetch the complete documentation index at: https://docs.serialized.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Market Lighthouse > The whole market in one call: totals, every chain, every exchange and every launchpad, with volumes, buy and sell volumes, transactions, traders, tokens created and migrations, from 5m to 24h, each with its previous window and its change. `GET /v1/lighthouse` · **5 credits** The whole market in one call: the total, every chain, every exchange and every launchpad, on the windows you pick (`5m`, `15m`, `30m`, `1h`, `4h`, `6h`, `12h`, `24h`; `5m,15m,1h,6h,24h` by default). Every window comes with `previous`, the window just before it of the same length, and `changePct`, the change between the two in percent. * `chains`: the chains to cover, comma-separated or as a list (`evm` = every EVM chain). Every chain by default. Every chain you ask for is in `chains[]`, with zeros when nothing traded. * `windows`: the windows, comma-separated or as a list. A window outside the list is refused with `400 INVALID_PARAM`, any other parameter with `400 UNKNOWN_PARAM`. The price is the same whatever you filter. The exchanges or launchpads of one chain are one call with `chains=`. ### The fields | Field | Meaning | | - | - | | `volumeUsd`, `buyVolumeUsd`, `sellVolumeUsd` | the USD volume traded in the window, then split into buys and sells. Each trade is valued at the native coin's USD rate at the time of the trade. Markets whose price can't be trusted (empty pools, unknown quote tokens) are left out of volumes, so a fake-volume market never inflates them. | | `volumeNative` | on each chain only: the same volume in the chain's native coin. | | `txns`, `buys`, `sells` | the swaps executed in the window, then by side (`buys + sells = txns`). A transaction routed through two markets counts once in each. On the total and each chain every market counts; exchanges and launchpads leave out markets with almost no activity. | | `traders` | on the total and each chain: the distinct wallets that traded in the window, on every market. A wallet active on several chains counts once in `total` when you ask for at most one EVM chain or for all of them; for a selection of several EVM chains, `total.traders` adds up the chains. | | `tokensCreated` | the tokens whose first market was created in the window; on a launchpad, the tokens launched there. | | `migrations` | the tokens that left their launch curve in the window, migrated to an exchange or graduated in place; on a launchpad, its own. | | `graduationRate` | `migrations / tokensCreated × 100`, capped at 100, `null` when no token was created. | | `previous` | the same fields over the window before. | | `changePct` | `(current − previous) / previous × 100`; `null` when the previous window is `0`. | `exchanges[]` groups every market by its exchange (`key` is the `pool.type` of [`/v1/pool`](https://docs.serialized.xyz/endpoints/pool-details) and [`/v1/meta/factories`](https://docs.serialized.xyz/endpoints/factories)), `launchpads[]` by its launchpad (`key` is `pool.factory`): a market born on a launchpad counts in both lists, under its exchange and under its launchpad. Both lists are sorted by volume over the longest window you ask for, carry `name`, `logo` and the `chains` they trade on, and leave out the ones with no activity. Exchanges carry the volumes and swaps; launchpads add `tokensCreated`, `migrations` and `graduationRate`. `total` and `chains[]` carry every field. A figure that can't be computed for a moment is `null`, never a partial sum: when one chain is unknown, the total of that field is `null` too. ```bash cURL (every chain) theme={null} curl 'https://api.serialized.xyz/v1/lighthouse' \ -H 'Authorization: YOUR_API_KEY' ``` ```bash cURL (Solana and Base, 24h) theme={null} curl 'https://api.serialized.xyz/v1/lighthouse?chains=solana,evm:8453&windows=24h' \ -H 'Authorization: YOUR_API_KEY' ``` ```json Response (chains=solana,evm:8453&windows=24h) theme={null} { "data": { "total": { "stats": { "24h": { "volumeUsd": 4723117094.04, "buyVolumeUsd": 2385625309.81, "sellVolumeUsd": 2337491784.23, "txns": 38698456, "buys": 22178599, "sells": 16519857, "traders": 1200631, "tokensCreated": 58150, "migrations": 3136, "graduationRate": 5.39, "previous": { "volumeUsd": 3264607905.34, "buyVolumeUsd": 1641537094.46, "sellVolumeUsd": 1623070810.88, "txns": 34074904, "buys": 19585472, "sells": 14489432, "traders": 1093103, "tokensCreated": 52608, "migrations": 2900, "graduationRate": 5.51 }, "changePct": { "volumeUsd": 44.68, "buyVolumeUsd": 45.33, "sellVolumeUsd": 44.02, "txns": 13.57, "buys": 13.24, "sells": 14.01, "traders": 9.84, "tokensCreated": 10.53, "migrations": 8.14 } } } }, "chains": [ { "chain": "solana", "name": "Solana", "stats": { "24h": { "volumeUsd": 3652735794.63, "buyVolumeUsd": 1839918462, "sellVolumeUsd": 1812817332.63, "volumeNative": 36136987.8975, "txns": 36380775, "buys": 21003878, "sells": 15376897, "traders": 1114071, "tokensCreated": 54438, "migrations": 3099, "graduationRate": 5.69, "previous": { "volumeUsd": 2742555516.33, "buyVolumeUsd": 1381961051.68, "sellVolumeUsd": 1360594464.65, "volumeNative": 27005970.1017, "txns": 32377336, "buys": 18710200, "sells": 13667136, "traders": 1004313, "tokensCreated": 49426, "migrations": 2885, "graduationRate": 5.84 }, "changePct": { "volumeUsd": 33.19, "buyVolumeUsd": 33.14, "sellVolumeUsd": 33.24, "volumeNative": 33.81, "txns": 12.36, "buys": 12.26, "sells": 12.51, "traders": 10.93, "tokensCreated": 10.14, "migrations": 7.42 } } } }, { "chain": "evm:8453", "name": "Base", "stats": { "24h": { "volumeUsd": 1070381299.41, "buyVolumeUsd": 545706847.81, "sellVolumeUsd": 524674451.6, "volumeNative": 461550.66, "txns": 2317681, "buys": 1174721, "sells": 1142960, "traders": 86560, "tokensCreated": 3712, "migrations": 37, "graduationRate": 1, "previous": { "volumeUsd": 522052389.01, "buyVolumeUsd": 259576042.78, "sellVolumeUsd": 262476346.23, "volumeNative": 222740.3343, "txns": 1697568, "buys": 875272, "sells": 822296, "traders": 88790, "tokensCreated": 3182, "migrations": 15, "graduationRate": 0.47 }, "changePct": { "volumeUsd": 105.03, "buyVolumeUsd": 110.23, "sellVolumeUsd": 99.89, "volumeNative": 107.21, "txns": 36.53, "buys": 34.21, "sells": 39, "traders": -2.51, "tokensCreated": 16.66, "migrations": 146.67 } } } } ], "exchanges": [ { "key": "PUMP_SWAP", "name": "PumpSwap", "logo": "https://serialized.cloud/logos/dex/pumpswap.4004b15c.webp", "chains": [ "solana" ], "stats": { "24h": { "volumeUsd": 1218686449.69, "buyVolumeUsd": 614625714.64, "sellVolumeUsd": 604060735.05, "txns": 16740825, "buys": 10706344, "sells": 6034481, "previous": { "volumeUsd": 1186554520.68, "buyVolumeUsd": 597958010.32, "sellVolumeUsd": 588596510.36, "txns": 16052411, "buys": 10121675, "sells": 5930736 }, "changePct": { "volumeUsd": 2.71, "buyVolumeUsd": 2.79, "sellVolumeUsd": 2.63, "txns": 4.29, "buys": 5.78, "sells": 1.75 } } } } ], "launchpads": [ { "key": "PUMPFUN", "name": "Pump.fun", "logo": "https://serialized.cloud/logos/dex/pumpfun.9eff8393.webp", "chains": [ "solana" ], "stats": { "24h": { "volumeUsd": 110335318.06, "buyVolumeUsd": 57902383.08, "sellVolumeUsd": 52432934.98, "txns": 4042768, "buys": 2138374, "sells": 1904394, "tokensCreated": 45526, "migrations": 1008, "graduationRate": 2.21, "previous": { "volumeUsd": 79012697.45, "buyVolumeUsd": 41628000.38, "sellVolumeUsd": 37384697.07, "txns": 3776084, "buys": 2025557, "sells": 1750527, "tokensCreated": 40256, "migrations": 902, "graduationRate": 2.24 }, "changePct": { "volumeUsd": 39.64, "buyVolumeUsd": 39.09, "sellVolumeUsd": 40.25, "txns": 7.06, "buys": 5.57, "sells": 8.79, "tokensCreated": 13.09, "migrations": 11.75 } } } } ] }, "meta": { "asOf": 1793051000000, "chains": [ "solana", "evm:8453" ], "windows": [ "24h" ] } } ``` ## OpenAPI ````yaml openapi.json GET /v1/lighthouse openapi: 3.1.0 info: title: Serialized Data API description: >- On-chain data for trading apps - tokens, candles, token filters. Built on our own indexers. 18 EVM chains + Solana, live. version: 0.1.0 servers: - url: https://demo.serialized.xyz description: 'Demo: no key needed, read endpoints, rate-limited per IP' - url: https://api.serialized.xyz description: 'Production: your API key in the Authorization header' security: - apiKey: [] - {} paths: /v1/lighthouse: get: summary: Market Lighthouse description: >- The whole market in one call: the total, every chain, every exchange and every launchpad, with volumes, buy and sell volumes, swaps, distinct traders, tokens created and migrations, on the windows you pick from 5m to 24h; every window carries its previous window and the change between the two. operationId: market-lighthouse parameters: - schema: anyOf: - type: string - type: array items: type: string x-default: solana,evm:8453 in: query name: chains required: false description: >- Chains to cover, comma-separated or as a list; `evm` = every EVM chain. Default: every chain. Every chain asked for is in `chains[]`. example: solana,evm:8453 - schema: anyOf: - type: string - type: array items: type: string x-default: 1h,24h in: query name: windows required: false description: >- Windows among `5m`, `15m`, `30m`, `1h`, `4h`, `6h`, `12h`, `24h`, comma-separated or as a list. Default: `5m,15m,1h,6h,24h`. example: 1h,24h responses: '200': description: Standard `{ data, meta }` envelope. components: securitySchemes: apiKey: type: apiKey name: Authorization in: header description: Your raw API key (not needed on the demo server). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.