curl 'https://api.serialized.xyz/v1/lighthouse' \
-H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/lighthouse?chains=solana,evm:8453&windows=24h' \
-H 'Authorization: YOUR_API_KEY'
{
"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"
]
}
}
Discovery
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
curl 'https://api.serialized.xyz/v1/lighthouse' \
-H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/lighthouse?chains=solana,evm:8453&windows=24h' \
-H 'Authorization: YOUR_API_KEY'
{
"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"
]
}
}
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 inchains[], with zeros when nothing traded.windows: the windows, comma-separated or as a list. A window outside the list is refused with400 INVALID_PARAM, any other parameter with400 UNKNOWN_PARAM.
chains=<that chain>.
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 and /v1/meta/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.
curl 'https://api.serialized.xyz/v1/lighthouse' \
-H 'Authorization: YOUR_API_KEY'
curl 'https://api.serialized.xyz/v1/lighthouse?chains=solana,evm:8453&windows=24h' \
-H 'Authorization: YOUR_API_KEY'
{
"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"
]
}
}
Authorizations
Your raw API key (not needed on the demo server).
Query Parameters
Chains to cover, comma-separated or as a list; evm = every EVM chain. Default: every chain. Every chain asked for is in chains[].
Windows among 5m, 15m, 30m, 1h, 4h, 6h, 12h, 24h, comma-separated or as a list. Default: 5m,15m,1h,6h,24h.
Response
200
Standard { data, meta } envelope.