> ## Documentation Index > Fetch the complete documentation index at: https://docs.mobula.io/llms.txt > Use this file to discover all available pages before exploring further. # Get Market Lighthouse > Retrieve aggregated real-time market metrics across all blockchains, DEXes, launchpads, and trading platforms. ## Overview The Market Lighthouse endpoint provides a high-level, real-time overview of on-chain trading activity across all supported blockchains, DEXes, launchpads, and trading platforms. Data is pre-computed and cached, refreshing every 5 minutes. ### Query Parameters | Parameter | Type | Required | Description | | ------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `blockchains` | string | No | Comma-separated list of blockchains to filter by. Accepts chain names (`Solana`, `Base`), short names (`BNB`), aliases (`BSC`), numeric chain IDs (`56`, `8453`), or internal IDs (`evm:56`, `solana:solana`). When omitted, returns data for all chains. | ### Usage Examples ```bash theme={null} # All chains curl -X GET "https://api.mobula.io/api/2/market/lighthouse" # Solana only curl -X GET "https://api.mobula.io/api/2/market/lighthouse?blockchains=Solana" # Multiple chains curl -X GET "https://api.mobula.io/api/2/market/lighthouse?blockchains=Solana,Base,BSC" ``` ### Response Format The response contains five top-level sections: | Section | Description | | ------------- | ----------------------------------------------------------------------------------- | | `total` | Aggregated metrics across all pools | | `byChain` | Metrics broken down by blockchain (Solana, Ethereum, BSC, etc.) | | `byDex` | Metrics broken down by DEX (Uniswap, Raydium, PancakeSwap, etc.) | | `byLaunchpad` | Metrics broken down by launchpad (PumpFun, etc.) | | `byPlatform` | Metrics broken down by trading platform (Axiom, BullX, Photon, GMGN, Phantom, etc.) | Each section contains the same set of metrics across four timeframes (15min, 1h, 6h, 24h): | Metric | Description | | ------------------- | ------------------------------------------------------ | | `volumeUSD` | Total trading volume in USD (double-sided: buy + sell) | | `volumeUSDChange` | Period-over-period change for volume (nullable) | | `trades` | Total number of trades | | `tradesChange` | Period-over-period change for trades (nullable) | | `buys` | Number of buy trades | | `buysChange` | Period-over-period change for buys (nullable) | | `sells` | Number of sell trades | | `sellsChange` | Period-over-period change for sells (nullable) | | `feesPaidUSD` | Total fees paid in USD | | `feesPaidUSDChange` | Period-over-period change for fees (nullable) | ### Example Response ```json theme={null} { "data": { "total": { "volumeUSD": { "15min": 52489210.42, "1h": 198402841.55, "6h": 1204820415.33, "24h": 4812049201.12 }, "volumeUSDChange": { "15min": 5.2, "1h": 3.1, "6h": -1.8, "24h": 2.4 }, "trades": { "15min": 142850, "1h": 520140, "6h": 3120840, "24h": 11284012 }, "tradesChange": { "15min": 2.1, "1h": 1.5, "6h": -0.8, "24h": 1.2 }, "buys": { "15min": 74201, "1h": 268402, "6h": 1610412, "24h": 5842001 }, "buysChange": { "15min": 3.0, "1h": 2.0, "6h": -0.5, "24h": 1.8 }, "sells": { "15min": 68649, "1h": 251738, "6h": 1510428, "24h": 5442011 }, "sellsChange": { "15min": 1.5, "1h": 0.8, "6h": -1.2, "24h": 0.6 }, "feesPaidUSD": { "15min": 48201.32, "1h": 182040.55, "6h": 1092243.30, "24h": 4201842.18 }, "feesPaidUSDChange": { "15min": 4.8, "1h": 2.5, "6h": -1.0, "24h": 2.0 } }, "byChain": [ { "name": "Solana", "logo": "https://...", "volumeUSD": { "15min": 32104820.11, "1h": 120481024.42, "6h": 722886146.52, "24h": 2910482041.55 }, "volumeUSDChange": { "15min": 4.1, "1h": 2.8, "6h": -1.2, "24h": 2.1 }, "trades": { "15min": 98420, "1h": 358201, "6h": 2149206, "24h": 7842001 }, "tradesChange": { "15min": 1.8, "1h": 1.2, "6h": -0.6, "24h": 0.9 }, "buys": { "15min": 51200, "1h": 185100, "6h": 1110600, "24h": 4021000 }, "buysChange": { "15min": 2.5, "1h": 1.8, "6h": -0.4, "24h": 1.5 }, "sells": { "15min": 47220, "1h": 173101, "6h": 1038606, "24h": 3821001 }, "sellsChange": { "15min": 1.2, "1h": 0.6, "6h": -0.9, "24h": 0.4 }, "feesPaidUSD": { "15min": 31042.11, "1h": 118042.33, "6h": 708253.98, "24h": 2810420.55 }, "feesPaidUSDChange": { "15min": 3.8, "1h": 2.2, "6h": -0.8, "24h": 1.7 } } ], "byDex": [ { "name": "Raydium", "logo": "https://...", "volumeUSD": { "15min": 18420104.22, "1h": 72048201.11, "6h": 432289206.66, "24h": 1704820104.33 }, "volumeUSDChange": { "15min": 3.5, "1h": 2.1, "6h": -0.9, "24h": 1.8 }, "trades": { "15min": 58201, "1h": 210420, "6h": 1262520, "24h": 4582010 }, "tradesChange": { "15min": 1.5, "1h": 0.9, "6h": -0.4, "24h": 0.7 }, "buys": { "15min": 30100, "1h": 108200, "6h": 649200, "24h": 2351000 }, "buysChange": { "15min": 2.0, "1h": 1.2, "6h": -0.3, "24h": 1.0 }, "sells": { "15min": 28101, "1h": 102220, "6h": 613320, "24h": 2231010 }, "sellsChange": { "15min": 1.0, "1h": 0.5, "6h": -0.6, "24h": 0.3 }, "feesPaidUSD": { "15min": 18204.11, "1h": 68420.22, "6h": 410521.32, "24h": 1620482.44 }, "feesPaidUSDChange": { "15min": 3.2, "1h": 1.8, "6h": -0.5, "24h": 1.4 } } ], "byLaunchpad": [ { "name": "PumpFun", "logo": "https://...", "volumeUSD": { "15min": 8420104.11, "1h": 32048201.22, "6h": 192289207.32, "24h": 782048201.33 }, "volumeUSDChange": { "15min": 2.8, "1h": 1.5, "6h": -0.7, "24h": 1.2 }, "trades": { "15min": 28420, "1h": 104201, "6h": 625206, "24h": 2284010 }, "tradesChange": { "15min": 1.2, "1h": 0.7, "6h": -0.3, "24h": 0.5 }, "buys": { "15min": 14800, "1h": 53800, "6h": 322800, "24h": 1172000 }, "buysChange": { "15min": 1.8, "1h": 1.0, "6h": -0.2, "24h": 0.8 }, "sells": { "15min": 13620, "1h": 50401, "6h": 302406, "24h": 1112010 }, "sellsChange": { "15min": 0.8, "1h": 0.4, "6h": -0.5, "24h": 0.2 }, "feesPaidUSD": { "15min": 8104.22, "1h": 30420.11, "6h": 182520.66, "24h": 742048.55 }, "feesPaidUSDChange": { "15min": 2.5, "1h": 1.2, "6h": -0.4, "24h": 1.0 } } ], "byPlatform": [ { "name": "Axiom", "logo": "https://i.imgur.com/aw63mVw.png", "volumeUSD": { "15min": 4820104.11, "1h": 18204820.22, "6h": 109228921.32, "24h": 420482041.33 }, "volumeUSDChange": { "15min": 2.2, "1h": 1.0, "6h": -0.5, "24h": 0.8 }, "trades": { "15min": 12420, "1h": 48201, "6h": 289206, "24h": 1042010 }, "tradesChange": { "15min": 0.9, "1h": 0.5, "6h": -0.2, "24h": 0.3 }, "buys": { "15min": 6400, "1h": 24800, "6h": 148800, "24h": 535000 }, "buysChange": { "15min": 1.3, "1h": 0.7, "6h": -0.1, "24h": 0.5 }, "sells": { "15min": 6020, "1h": 23401, "6h": 140406, "24h": 507010 }, "sellsChange": { "15min": 0.5, "1h": 0.2, "6h": -0.3, "24h": 0.1 }, "feesPaidUSD": { "15min": 4820.11, "1h": 18042.22, "6h": 108253.32, "24h": 398204.44 }, "feesPaidUSDChange": { "15min": 1.8, "1h": 0.8, "6h": -0.3, "24h": 0.6 } } ] } } ``` ## OpenAPI ````yaml get /2/market/lighthouse openapi: 3.0.0 info: version: 1.0.0 title: Mobula API description: >- Documentation of the Mobula API **Demo API**: The default server (demo-api.mobula.io) is a demo API with rate limits. For production use, please use api.mobula.io with an API key from https://admin.mobula.io servers: - url: https://demo-api.mobula.io/api/ description: Demo API (rate limited, for testing only) - url: https://api.mobula.io/api/ description: Production API (requires API key) security: [] tags: - name: V2 - Token description: Token details, price, security, ATH, and holder data - name: V2 - Market Data description: Market details, OHLCV history, and lighthouse metrics - name: V2 - Trades description: Token trades, enriched trades, and trade filters - name: V2 - Wallet description: Wallet positions, activity, trades, analysis, and labels - name: V2 - Assets description: Cross-chain asset details and price history - name: V2 - Swap description: Swap quoting and execution - name: V2 - Perps description: Perpetual futures quoting, execution, and positions - name: V2 - Bridge description: Cross-chain bridge quoting and intent status (Alpha Preview) - name: V2 - DeFi description: Bonding pools and pulse data - name: V2 - Search description: Universal fast search - name: V2 - Usage description: Per-key API and WebSocket usage history - name: V2 - Blockchains description: System metadata and chain listings - name: V2 - Prediction Markets description: >- Polymarket markets/events, wallet positions, and the full execution stack (auth, order build/submit/cancel, approvals, pUSD wrap/unwrap, deploy, deposit/withdraw, redeem). Alpha — see /api/2/pm/*. - name: V1 - Market Data description: Market prices, history, sparklines, pairs, and multi-data - name: V1 - Wallet description: Wallet portfolio, transactions, history, and NFTs - name: V1 - Token description: First buyers - name: V1 - Trades description: Market trades by pair - name: V1 - Metadata description: Token metadata, categories, trendings, and news - name: V1 - Assets description: List all assets - name: V1 - Search description: Search for assets, tokens, and pairs - name: V1 - DeFi description: Bonding pool pulse data - name: V1 - Blockchains description: Blockchain listings, pairs, and stats - name: V1 - Webhooks description: Webhook management - name: V1 - Feed description: Custom feed creation paths: /2/market/lighthouse: get: tags: - V2 - Market Data summary: Get market lighthouse metrics description: >- Retrieve aggregated real-time market metrics across all blockchains, DEXes, launchpads, and trading platforms. responses: '200': description: Market lighthouse response content: application/json: schema: type: object properties: data: type: object properties: total: type: object properties: volumeUSD: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h volumeUSDChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h trades: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h tradesChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h buys: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h buysChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h sells: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h sellsChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h feesPaidUSD: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h feesPaidUSDChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h required: - volumeUSD - volumeUSDChange - trades - tradesChange - buys - buysChange - sells - sellsChange - feesPaidUSD - feesPaidUSDChange byChain: type: array items: type: object properties: volumeUSD: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h volumeUSDChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h trades: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h tradesChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h buys: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h buysChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h sells: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h sellsChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h feesPaidUSD: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h feesPaidUSDChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h name: type: string logo: type: string required: - volumeUSD - volumeUSDChange - trades - tradesChange - buys - buysChange - sells - sellsChange - feesPaidUSD - feesPaidUSDChange - name - logo byDex: type: array items: type: object properties: volumeUSD: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h volumeUSDChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h trades: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h tradesChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h buys: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h buysChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h sells: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h sellsChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h feesPaidUSD: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h feesPaidUSDChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h name: type: string logo: type: string nullable: true required: - volumeUSD - volumeUSDChange - trades - tradesChange - buys - buysChange - sells - sellsChange - feesPaidUSD - feesPaidUSDChange - name - logo byLaunchpad: type: array items: type: object properties: volumeUSD: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h volumeUSDChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h trades: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h tradesChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h buys: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h buysChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h sells: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h sellsChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h feesPaidUSD: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h feesPaidUSDChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h name: type: string logo: type: string nullable: true required: - volumeUSD - volumeUSDChange - trades - tradesChange - buys - buysChange - sells - sellsChange - feesPaidUSD - feesPaidUSDChange - name - logo byPlatform: type: array items: type: object properties: volumeUSD: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h volumeUSDChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h trades: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h tradesChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h buys: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h buysChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h sells: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h sellsChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h feesPaidUSD: type: object properties: 15min: type: number 1h: type: number 6h: type: number 24h: type: number required: - 15min - 1h - 6h - 24h feesPaidUSDChange: type: object properties: 15min: type: number nullable: true 1h: type: number nullable: true 6h: type: number nullable: true 24h: type: number nullable: true required: - 15min - 1h - 6h - 24h name: type: string logo: type: string nullable: true required: - volumeUSD - volumeUSDChange - trades - tradesChange - buys - buysChange - sells - sellsChange - feesPaidUSD - feesPaidUSDChange - name - logo required: - total - byChain - byDex - byLaunchpad - byPlatform required: - data ````