Skip to main content
GET
/
2
/
market
/
lighthouse
Get market lighthouse metrics
curl --request GET \
  --url https://demo-api.mobula.io/api/2/market/lighthouse
{
  "data": {
    "total": {
      "volumeUSD": {
        "15min": 123,
        "1h": 123,
        "6h": 123,
        "24h": 123
      },
      "volumeUSDChange": {
        "15min": 123,
        "1h": 123,
        "6h": 123,
        "24h": 123
      },
      "trades": {
        "15min": 123,
        "1h": 123,
        "6h": 123,
        "24h": 123
      },
      "tradesChange": {
        "15min": 123,
        "1h": 123,
        "6h": 123,
        "24h": 123
      },
      "buys": {
        "15min": 123,
        "1h": 123,
        "6h": 123,
        "24h": 123
      },
      "buysChange": {
        "15min": 123,
        "1h": 123,
        "6h": 123,
        "24h": 123
      },
      "sells": {
        "15min": 123,
        "1h": 123,
        "6h": 123,
        "24h": 123
      },
      "sellsChange": {
        "15min": 123,
        "1h": 123,
        "6h": 123,
        "24h": 123
      },
      "feesPaidUSD": {
        "15min": 123,
        "1h": 123,
        "6h": 123,
        "24h": 123
      },
      "feesPaidUSDChange": {
        "15min": 123,
        "1h": 123,
        "6h": 123,
        "24h": 123
      }
    },
    "byChain": [
      {
        "volumeUSD": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "volumeUSDChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "trades": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "tradesChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "buys": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "buysChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "sells": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "sellsChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "feesPaidUSD": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "feesPaidUSDChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "name": "<string>",
        "logo": "<string>"
      }
    ],
    "byDex": [
      {
        "volumeUSD": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "volumeUSDChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "trades": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "tradesChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "buys": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "buysChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "sells": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "sellsChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "feesPaidUSD": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "feesPaidUSDChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "name": "<string>",
        "logo": "<string>"
      }
    ],
    "byLaunchpad": [
      {
        "volumeUSD": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "volumeUSDChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "trades": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "tradesChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "buys": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "buysChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "sells": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "sellsChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "feesPaidUSD": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "feesPaidUSDChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "name": "<string>",
        "logo": "<string>"
      }
    ],
    "byPlatform": [
      {
        "volumeUSD": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "volumeUSDChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "trades": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "tradesChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "buys": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "buysChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "sells": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "sellsChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "feesPaidUSD": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "feesPaidUSDChange": {
          "15min": 123,
          "1h": 123,
          "6h": 123,
          "24h": 123
        },
        "name": "<string>",
        "logo": "<string>"
      }
    ]
  }
}

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

ParameterTypeRequiredDescription
blockchainsstringNoComma-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

# 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:
SectionDescription
totalAggregated metrics across all pools
byChainMetrics broken down by blockchain (Solana, Ethereum, BSC, etc.)
byDexMetrics broken down by DEX (Uniswap, Raydium, PancakeSwap, etc.)
byLaunchpadMetrics broken down by launchpad (PumpFun, etc.)
byPlatformMetrics 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):
MetricDescription
volumeUSDTotal trading volume in USD (double-sided: buy + sell)
volumeUSDChangePeriod-over-period change for volume (nullable)
tradesTotal number of trades
tradesChangePeriod-over-period change for trades (nullable)
buysNumber of buy trades
buysChangePeriod-over-period change for buys (nullable)
sellsNumber of sell trades
sellsChangePeriod-over-period change for sells (nullable)
feesPaidUSDTotal fees paid in USD
feesPaidUSDChangePeriod-over-period change for fees (nullable)

Example Response

{
  "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 }
      }
    ]
  }
}

Response

200 - application/json

Market lighthouse response

data
object
required