CLOBr Logo

API Endpoints

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

Table of Contents

Quick Reference

MethodEndpointDescriptionTier
GET/score/:addressGet single token scorePremium+
POST/scoreBatch query up to 50 tokensEnterprise
GET/top-scoresTop 50 tokens by CLOBr scorePremium+
GET/market-depthMarket depth data for a tokenPremium+

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

StatusMeaning
availableToken analyzed, all data populated
pendingNew token, waiting for analysis (~15 seconds)
unsupportedToken excluded (stablecoins, wrapped tokens)
price_unavailableToken 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: Must use delayed=true (1-hour delayed data)
Enterprise: Can access real-time data

Parameters

NameRequiredDescription
token_addressYesToken address to query
exchange_typeNoDEX (default), CEX, or ALL
currencyNoUSD (default) or SOL
low_pct_changeNoLower bound % change (-0.9 to 10.0)
high_pct_changeNoUpper bound % change (-0.9 to 10.0)
delayedNotrue for delayed data (required for Premium)

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