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

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 /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

Example Request

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

Response Format

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

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

←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