API Endpoints

curl -X GET "https://clobr.io/api/v1/score/9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump" \
  -H "x-api-key: your_api_key_here"

{
  "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
  "chain": "solana",
  "symbol": "FARTCOIN",
  "name": "Fartcoin",
  "clobr_score": 53.1,
  "score_msg": "Balanced: Similar levels of support and resistance",
  "clobr_last_run": "2025-09-15T10:30:00Z",
  "clobr_current_price": 0.69420,
  "status": "available"
}

This endpoint never returns 404. An address we have no row for comes back 200 with status: "pending", because logging the request queues the token for analysis. See the status table below.

curl -X POST "https://clobr.io/api/v1/score" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "addresses": [
      "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
      "0x4a3b1c2d5e6f7089a1b2c3d4e5f60718293a4b5c"
    ]
  }'

chain is optional in the body. Omit it and every address is answered on its own chain.

{
  "count": 2,
  "tokens": [
    {
      "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
      "chain": "solana",
      "symbol": "FARTCOIN",
      "clobr_score": 53.1,
      "status": "available"
    },
    {
      "address": "0x4a3b1c2d5e6f7089a1b2c3d4e5f60718293a4b5c",
      "chain": "robinhood",
      "symbol": null,
      "clobr_score": null,
      "status": "pending"
    }
  ]
}

curl -X GET "https://clobr.io/api/v1/top-scores?chain=all" \
  -H "x-api-key: your_api_key_here"

{
  "chain": "all",
  "count": 50,
  "tokens": [
    {
      "address": "...",
      "chain": "solana",
      "symbol": "FARTCOIN",
      "clobr_score": 95.6,
      "clobr_current_price": 0.69420,
      "status": "available"
    },
    {
      "address": "0x4a3b1c2d5e6f7089a1b2c3d4e5f60718293a4b5c",
      "chain": "robinhood",
      "symbol": "HOOD",
      "clobr_score": 91.2,
      "clobr_current_price": 1.24,
      "status": "available"
    },
    ...
  ]
}

The top-level chain echoes the effective filter ("solana" when you sent nothing). Each token carries the chain it actually lives on.

curl -X GET "https://clobr.io/api/v1/market-depth?token_address=9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump&delayed=true&include_summary=true" \
  -H "x-api-key: your_api_key_here"

{
  "query_parameters": {
    "token_address": "...",
    "exchange_type": "DEX",
    "currency": "USD",
    "delayed": true,
    "include_summary": true,
    "chain": "solana"
  },
  "chain": "solana",
  "last_refresh": 1747593235,
  "clobr_score": 53.1,
  "score_msg": "Balanced: Similar levels of support and resistance",
  "price": 0.00151,
  "depth_data": [
    {
      "price": 0.00164,
      "support": 0,
      "resistance": 5553.40,
      "constant_product": 945.11
    },
    ...
  ],
  "summary": {
    "by_exchange_type": [
      { "exchange_type": "DEX", "support": 38000.00, "resistance": 40000.00 }
    ],
    "by_source": [
      { "source": "Orca Whirlpool", "support": 20000.00, "resistance": 25000.00 },
      { "source": "Meteora DLMM", "support": 18000.00, "resistance": 15000.00 }
    ],
    "constant_product": 3186681.11
  }
}

chain is the chain the token address resolved to (solana for a base58 mint, robinhood for a 0x Robinhood Chain contract address). It is always present, at the top level and inside query_parameters.

The summary object is only returned when include_summary=true. Aggregations honor the same token_address, percentage range, exchange_type filter, and currency conversion as depth_data. by_exchange_type and by_source cover concentrated liquidity (CLMM/DLMM/limit orders); constant-product AMM liquidity is reported separately under constant_product.

curl -X GET "https://clobr.io/api/v1/dca-pressure?sort_by=impact&sort_timeframe=1_hr&limit=10" \
  -H "x-api-key: your_api_key_here"

{
  "query_parameters": {
    "sort_by": "impact",
    "sort_timeframe": "1_hr",
    "include_orders": false,
    "limit": 10,
    "chain": "solana"
  },
  "count": 10,
  "tokens": [
    {
      "token": {
        "address": "98sMhvDwXj1RQi5c5Mndm3vPe9cBqPrbLaufMXFNMh5g",
        "chain": "solana",
        "symbol": "HYPE",
        "name": "HYPE",
        "icon": "https://...",
        "mcap": 5250000000,
        "liquidity_usd": 525000,
        "price_usd": 0.001
      },
      "buy_order_count": 5,
      "sell_order_count": 0,
      "total_buy_usd": 371518.97,
      "total_sell_usd": 0,
      "net_usd": 371518.97,
      "impact": {
        "net_usd_5_min": 100.50,
        "net_usd_30_min": 500.25,
        "net_usd_1_hr": 1200.00,
        "net_usd_6_hr": 8000.00,
        "net_usd_24_hr": 369369.07,
        "net_pct_5_min": 0.02,
        "net_pct_30_min": 0.08,
        "net_pct_1_hr": 0.15,
        "net_pct_6_hr": 0.90,
        "net_pct_24_hr": 0.07
      },
      "orders": []
    }
  ]
}

curl -X GET "https://clobr.io/api/v1/dca-orders?token_address=9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump&sort_by=usd_flow&limit=10" \
  -H "x-api-key: your_api_key_here"

{
  "query_parameters": {
    "token_address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
    "sort_by": "usd_flow",
    "limit": 10,
    "chain": "solana"
  },
  "token": {
    "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
    "chain": "solana",
    "symbol": "FARTCOIN",
    "name": "Fartcoin",
    "mcap": 850000000,
    "liquidity_usd": 12500000,
    "clobr_score": 53.1,
    "price_usd": 0.69420,
    "last_refresh": 1747593235
  },
  "count": 10,
  "orders": [
    {
      "dca_address": "...",
      "chain": "solana",
      "direction": "BUY",
      "symbol": "FARTCOIN",
      "paired_symbol": "SOL",
      "deposited_usd": 5000,
      "remaining_usd": 3200,
      "pct_filled": 0.36,
      "in_active_range": true,
      "cycle_frequency": 3600,
      "price_range": {
        "min_usd": 0.50,
        "max_usd": 1.00,
        "current_price_usd": 0.694
      },
      "flow_projections": {
        "usd_next_5_min": 12.50,
        "usd_next_30_min": 75.00,
        "usd_next_1_hr": 150.00,
        "usd_next_6_hr": 900.00,
        "usd_next_24_hr": 3200.00
      }
    }
  ]
}

curl -X GET "https://clobr.io/api/v1/limit-orders?token_address=9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump&low_pct_change=-0.5&high_pct_change=2.0&chain=all" \
  -H "x-api-key: your_api_key_here"

{
  "query_parameters": {
    "token_address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
    "low_pct_change": -0.5,
    "high_pct_change": 2.0,
    "limit": 100,
    "chain": "all"
  },
  "token": {
    "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
    "chain": "solana",
    "symbol": "FARTCOIN",
    "name": "Fartcoin",
    "mcap": 850000000,
    "liquidity_usd": 12500000,
    "clobr_score": 53.1,
    "price_usd": 0.69420,
    "last_refresh": 1747593235
  },
  "count": 42,
  "orders": [
    {
      "order_address": "...",
      "chain": "solana",
      "direction": "BUY",
      "platform": "jupiter",
      "symbol": "FARTCOIN",
      "paired_symbol": "SOL",
      "maker": "...",
      "usd_price": 0.55,
      "current_price_usd": 0.694,
      "pct_away": -0.21,
      "usd_support_amount": 2500.00,
      "usd_resistance_amount": 0,
      "pct_complete": 15.5,
      "created_at": 1747500000
    }
  ]
}

query_parameters.chain echoes the filter that was applied (all here). token.chain is the chain the queried address lives on, and each order's chain is the leg that order sits on — with chain=all a single response can mix them.

curl -X GET "https://clobr.io/api/v1/whale-activity?token_address=9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump&include=summary,sparkline,wallets&wallet_limit=50" \
  -H "x-api-key: your_api_key_here"

{
  "token_address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
  "chain": "solana",
  "has_coverage": true,
  "last_snapshot_at": "2025-09-15T10:30:00Z",
  "windows": ["1d", "7d", "30d"],
  "tiers": ["top20", "top50", "top100"],
  "summary": {
    "accumulating": {
      "top20":  { "1d": 4, "7d": 9,  "30d": 12 },
      "top50":  { "1d": 8, "7d": 21, "30d": 31 },
      "top100": { "1d": 13, "7d": 38, "30d": 57 }
    },
    "new_wallets": {
      "top20":  { "1d": 1, "7d": 2, "30d": 3 },
      "top50":  { "1d": 2, "7d": 5, "30d": 9 },
      "top100": { "1d": 3, "7d": 8, "30d": 15 }
    },
    "net_flow": {
      "top20":  { "1d": { "net": 1250000, "inflow": 1400000, "outflow": -150000 }, "7d": { "...": "..." }, "30d": { "...": "..." } },
      "top50":  { "...": "..." },
      "top100": { "...": "..." }
    }
  },
  "sparkline": {
    "top20": [
      { "day": "2025-08-17", "accumulating": 2, "new_wallets": 0, "net": 320000, "inflow": 400000, "outflow": -80000 }
    ],
    "top50": [ "..." ],
    "top100": [ "..." ]
  },
  "wallets": [
    {
      "rank": 1,
      "owner": "5Q544fKr...",
      "balance": 12750000,
      "balance_change": {
        "1d":  { "tokens": 0,       "pct": 0 },
        "7d":  { "tokens": 250000,  "pct": 2.0 },
        "14d": { "tokens": 750000,  "pct": 6.2 },
        "30d": { "tokens": 12750000, "pct": null }
      }
    }
  ]
}

balance_change.pct is null for brand-new positions (no pre-window balance). When has_coverage is false the token has not been backfilled yet and summary/wallets are empty.

curl -X POST "https://clobr.io/api/v1/whale-activity" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "token_addresses": [
      "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
      "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr"
    ],
    "include": ["summary", "sparkline"]
  }'

The body also accepts an optional chain field (solana or all). Each address's chain comes from its shape, so it is only an assertion.

{
  "chain": "solana",
  "count": 2,
  "tokens": [
    {
      "token_address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
      "chain": "solana",
      "has_coverage": true,
      "last_snapshot_at": "2025-09-15T10:30:00Z",
      "summary": { "accumulating": { "...": "..." }, "new_wallets": { "...": "..." }, "net_flow": { "...": "..." } },
      "sparkline": { "top20": ["..."], "top50": ["..."], "top100": ["..."] }
    },
    {
      "token_address": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
      "chain": "solana",
      "has_coverage": false,
      "last_snapshot_at": null
    }
  ]
}

curl -X GET "https://clobr.io/api/v1/dlmm/9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump" \
  -H "x-api-key: your_api_key_here"

{
  "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
  "chain": "solana",
  "period": "1h",
  "pools": [
    {
      "pubkey": "Ah2sM6ZzR8YpXv1kQ3n7DfWcJL9uTbEo5RgNhKmSPqV",
      "bin_step": 100,
      "active_id": 8388608,
      "token_x_mint": "So11111111111111111111111111111111111111112",
      "token_x_symbol": "SOL",
      "token_x_icon": "https://...",
      "token_x_decimals": 9,
      "token_x_price": 172.4,
      "token_y_mint": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
      "token_y_symbol": "SOLdiers",
      "token_y_icon": "https://...",
      "token_y_decimals": 6,
      "token_y_price": 0.0000249,
      "pool_price": 0.0000249,
      "base_fee_pct": 1.0,
      "dynamic_fee_pct": 3.58,
      "reserve_x": 350.2,
      "reserve_x_usd": 60000,
      "reserve_y": 2100000000,
      "reserve_y_usd": 52900,
      "total_liquidity_usd": 112900,
      "num_positions": 0,
      "num_wallets": 0,
      "stats_1h": {
        "fees": 2000,
        "volume": 585100,
        "effectiveFeeBps": 34.2,
        "feesPerAvgTvl": 0.0163,
        "rangeYield": 0.125,
        "rangeTvl": 16000,
        "feeCapture": 1.4,
        "captureShare": 0.55,
        "tvl": 585100
      },
      "chips": []
    }
  ],
  "chips": {
    "definitions": [
      { "key": "feesPerAvgTvl", "label": "Top $/TVL", "tip": "..." },
      { "key": "rangeYield", "label": "Top range yield", "tip": "..." },
      { "key": "fees", "label": "Most fees", "tip": "..." }
    ],
    "leaders": {
      "feesPerAvgTvl": "Ah2sM6ZzR8YpXv1kQ3n7DfWcJL9uTbEo5RgNhKmSPqV",
      "rangeYield": "Ah2sM6ZzR8YpXv1kQ3n7DfWcJL9uTbEo5RgNhKmSPqV",
      "fees": "Ah2sM6ZzR8YpXv1kQ3n7DfWcJL9uTbEo5RgNhKmSPqV"
    }
  }
}

curl -X GET "https://clobr.io/api/v1/dlmm-pools?period=1h&sort=feespertvl&minTvl=10000" \
  -H "x-api-key: your_api_key_here"

{
  "chain": "solana",
  "period": "1h",
  "sort": "feespertvl",
  "minTvl": 10000,
  "mint": null,
  "count": 50,
  "data": [
    {
      "address": "Ah2sM6ZzR8YpXv1kQ3n7DfWcJL9uTbEo5RgNhKmSPqV",
      "baseSymbol": "SOL",
      "quoteSymbol": "SOLdiers",
      "baseMint": "So11111111111111111111111111111111111111112",
      "quoteMint": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
      "tokenIcon": "https://...",
      "tvl": 585100,
      "binStep": 100,
      "baseFeePct": 1.0,
      "volume": 585100,
      "fees": 2000,
      "effectiveFeeBps": 34.2,
      "captureShare": 0.55,
      "feeCapture": 1.4,
      "tokenPoolCount": 5,
      "rangeTvl": 16000,
      "rangeYield": 0.125,
      "rangeCeiling": 0.31,
      "feesPerAvgTvl": 0.0163
    }
  ]
}

curl -X GET "https://clobr.io/api/v1/lp-cheat-sheet?window=1h&denominator=near&limit=25" \
  -H "x-api-key: your_api_key_here"

{
  "chain": "solana",
  "window": "1h",
  "denominator": "near",
  "limit": 25,
  "count": 25,
  "data": [
    {
      "rank": 1,
      "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
      "chain": "solana",
      "symbol": "SOLdiers",
      "name": "SOLdiers",
      "icon": "https://...",
      "organic_volume": 585100,
      "denom_liquidity_usd": 112900,
      "fee_density": 5.18
    }
  ]
}

Tokens with under $1,000 of near-price liquidity are excluded (denominator floor).

curl --compressed "https://clobr.io/api/v1/replay/pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn?from=2026-10-03T19:30:58Z&to=2026-10-03T20:30:58Z" \
  -H "x-api-key: your_api_key_here"

{
  "token": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn",
  "chain": "solana",
  "window": {
    "from": 1791053458,
    "to": 1791057058,
    "clamped": false,
    "served_from": 1791053474,
    "served_to": 1791053848
  },
  "next_from": 1791053857,
  "group": "market",
  "filter": { "types": null, "venues": null, "exclude_types": null,
              "exclude_venues": null, "venues_not_found": [] },
  "markets_mode": "split",
  "min_pct": -50,
  "max_pct": 100,
  "bin_ratio": 1.01,
  "snapshot_count": 15,
  "row_count": 94619,
  "markets": [
    { "source": "Meteora DLMM", "exchange_type": "DEX",
      "address": "4C8KctYZtMTZwV83Y5AcTPVT2aXYYu2t9ZhHdotFGnno", "pair": "MET" },
    { "source": "Meteora DLMM", "exchange_type": "DEX",
      "address": "D7CCRNx6e2ck22P8N93xqJ2Kbcu13RmYVFYeVRqAyN8n", "pair": "SOL" }
  ],
  "snapshots": [
    {
      "t": 1791053474,
      "tier": "raw",
      "price_usd": 0.006302025402746,
      "market_idx": [1, 1, 1],
      "bin": [-1, 0, 1],
      "support_usd": [60.31, 0, 0],
      "resistance_usd": [0, 60.31, 120.62]
    }
  ]
}

A 0x address that is the Robinhood Chain leg of a token that also trades on Solana is answered from the Solana mint, named in resolved_token. Cells under $1 per market and bin are left out. With group=all, markets is empty and snapshots have no market_idx. With group=venue or type, cells index groups through group_idx instead.