API Endpoints

Complete reference for all CLOBr API endpoints with request/response examples.

Quick Reference
GET /score/:address
POST /score (Batch)
GET /top-scores
GET /market-depth
GET /dca-pressure
GET /dca-orders
GET /limit-orders
GET /whale-activity
POST /whale-activity (Bulk)

Quick Reference

Method	Endpoint	Description	Tier
GET	/score/:address	Get single token score	Premium+
POST	/score	Batch query up to 50 tokens	Enterprise
GET	/top-scores	Top 50 tokens by CLOBr score	Premium+
GET	/market-depth	Market depth data for a token	Premium+
GET	/dca-pressure	Top tokens ranked by DCA pressure	Premium+
GET	/dca-orders	DCA orders with flow projections	Premium+
GET	/limit-orders	Limit orders with price range filters	Premium+
GET	/whale-activity	Whale accumulation & holder-flow for a token	Premium+
POST	/whale-activity	Bulk whale summary for up to 10 tokens	Premium+

GET /score/:address

Get CLOBr score and price data for a single token. Tokens not yet analyzed will have null values with a status message.

Example Request

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

Response Format

{
  "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
  "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"
}

POST /score Enterprise Only

Batch query CLOBr scores for up to 50 tokens at once. Returns sparse data - tokens not yet analyzed will have null values.

Example Request

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",
      "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr"
    ]
  }'

Response Format

{
  "count": 2,
  "tokens": [
    {
      "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
      "symbol": "FARTCOIN",
      "clobr_score": 53.1,
      "status": "available"
    },
    {
      "address": "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr",
      "symbol": null,
      "clobr_score": null,
      "status": "pending"
    }
  ]
}

Status Values

Status	Meaning
`available`	Token analyzed, all data populated
`pending`	New token, waiting for analysis (~15 seconds)
`unsupported`	Token excluded (stablecoins, wrapped tokens)
`price_unavailable`	Token supported but no price data from Jupiter

GET /top-scores

Returns the top 50 tokens ranked by CLOBr score. No parameters required.

Example Request

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

Response Format

{
  "count": 50,
  "tokens": [
    {
      "address": "...",
      "symbol": "FARTCOIN",
      "clobr_score": 95.6,
      "clobr_current_price": 0.69420,
      "status": "available"
    },
    ...
  ]
}

GET /market-depth

Returns market depth data for a specific token.

Premium: Live data at 10 requests per minute
Enterprise: Real-time data with custom rate limits

Parameters

Name	Required	Description
token_address	Yes	Token address to query
exchange_type	No	DEX (default), CEX, or ALL
currency	No	USD (default) or SOL
low_pct_change	No	Lower bound % change (-0.9 to 10.0)
high_pct_change	No	Upper bound % change (-0.9 to 10.0)
delayed	No	true for delayed data
include_summary	No	true to include aggregated support/resistance totals broken down by exchange_type and source, plus a total constant-product liquidity figure (default: false). Returned under a top-level `summary` object.

Example Request

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"

Response Format

{
  "query_parameters": {
    "token_address": "...",
    "exchange_type": "DEX",
    "currency": "USD",
    "delayed": true,
    "include_summary": true
  },
  "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
  }
}

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.

GET /dca-pressure

Returns the top tokens ranked by aggregate DCA (Dollar Cost Average) pressure. Includes net buy/sell totals and impact projections across multiple timeframes (5min to 24hr). Optionally includes nested individual orders per token.

Rate limit: 6 requests per minute (data updates every ~15 seconds)

Parameters

Name	Required	Description
sort_by	No	usd (default) or impact (percentage)
sort_dir	No	desc (default, buy pressure first) or asc (sell pressure first)
sort_timeframe	No	5_min, 30_min, 1_hr, 6_hr, 24_hr (default)
include_orders	No	true to include nested individual orders per token (default: false)
order_limit	No	Max orders per token when include_orders=true (default 5, max 20)
limit	No	Number of tokens to return (default 20, max 50)
min_mcap / max_mcap	No	Market cap filter range (USD)
min_liquidity / max_liquidity	No	Liquidity filter range (USD)

Example Request

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"

Response Format

{
  "query_parameters": {
    "sort_by": "impact",
    "sort_timeframe": "1_hr",
    "include_orders": false,
    "limit": 10
  },
  "count": 10,
  "tokens": [
    {
      "token": {
        "address": "98sMhvDwXj1RQi5c5Mndm3vPe9cBqPrbLaufMXFNMh5g",
        "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": []
    }
  ]
}

GET /dca-orders

Returns top DCA (Dollar Cost Average) orders for a token, sorted by percentage impact or USD flow. Includes active order details with time-based flow projections. Ideal for identifying large DCA buy/sell pressure to feed trading bots and terminals.

Parameters

Name	Required	Description
token_address	Yes	Token mint address
sort_by	No	pct_impact (default) or usd_flow
min_mcap / max_mcap	No	Market cap filter range (USD)
min_liquidity / max_liquidity	No	Liquidity filter range (USD)
limit	No	Max orders to return (default 20, max 50)

Example Request

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"

Response Format

{
  "query_parameters": {
    "token_address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
    "sort_by": "usd_flow",
    "limit": 10
  },
  "token": {
    "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
    "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": "...",
      "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
      }
    }
  ]
}

GET /limit-orders

Returns active limit orders for a token within a specified percentage range of current price. Default range is -90% to +1000%. Includes orders from both Jupiter and Fusion platforms. Use the optional pct range parameters to narrow results.

Parameters

Name	Required	Description
token_address	Yes	Token mint address
low_pct_change	No	Lower bound % change (-0.99 to 10.0, default -0.9)
high_pct_change	No	Upper bound % change (-0.99 to 10.0, default 10.0)
limit	No	Max orders to return (default 100, max 500)

Example Request

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

Response Format

{
  "query_parameters": {
    "token_address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
    "low_pct_change": -0.5,
    "high_pct_change": 2.0,
    "limit": 100
  },
  "token": {
    "address": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump",
    "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": "...",
      "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
    }
  ]
}

GET /whale-activity

Returns the Whale Accumulation panel data for a single Solana token by contract address. Includes accumulating wallets, brand-new wallets and net flow bucketed by holder tier (top 20 / 50 / 100) over 1D / 7D / 30D windows, a 30-day daily sparkline per tier, and (optionally) the top-holder table with per-wallet 1D/7D/14D/30D balance change and an optional 30-day activity trend.

Chain: Solana only
Rate limit: 1 request per second (cache responses ~60s — snapshot data refreshes roughly each minute)

Parameters

Name	Required	Description
token_address	Yes	Solana token mint address
include	No	Comma-separated sections: summary, sparkline, wallets (default: all three)
wallet_limit	No	Top holders to return: 20, 50, or 100 (default 100)
wallet_activity	No	true to attach a 30-day daily activity trend per wallet (heavier payload, default false)

Example Request

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"

Response Format

{
  "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.

POST /whale-activity Bulk

Returns whale accumulation summary (and optional sparkline) for up to 10 Solana tokens in one request. Wallet tables are not available in bulk — use the single-token GET for those. Tokens without coverage come back with has_coverage: false.

Max tokens: 10 per request
Rate limit: 6 requests per minute (quota cost = number of tokens requested)

Example Request

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

Response Format

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

←PreviousAuthentication

NextCode Examples→

API Endpoints

Table of Contents

Quick Reference

GET /score/:address

Example Request

Response Format

POST /score Enterprise Only

Example Request

Response Format

Status Values

GET /top-scores

Example Request

Response Format

GET /market-depth

Parameters

Example Request

Response Format

GET /dca-pressure

Parameters

Example Request

Response Format

GET /dca-orders

Parameters

Example Request

Response Format

GET /limit-orders

Parameters

Example Request

Response Format

GET /whale-activity

Parameters

Example Request

Response Format

POST /whale-activity Bulk

Example Request

Response Format