checkr api

endpoints

GET /v1/leaderboard $0.02 ▼

tokens ranked by attention share

query params

param	values	default
?limit=	1 – 50	10
?hours=	1 / 2 / 4 / 8 / 12 / 24	4
?sort_by=	ATT_pct \| MS_pct \| INF_pct \| velocity \| ATT_delta	ATT_pct
?min_mentions=	integer	5

example response

{
  "updated_at": "2026-03-06T19:47:00Z",
  "delta_hours": 2,
  "tokens": [
    {
      "symbol": "BNKR",
      "ATT_pct": 9.97,
      "MS_pct": 8.2,
      "INF_pct": 11.4,
      "velocity": 2.1,
      "ATT_delta": 1.3
    },
    {
      "symbol": "TOSHI",
      "ATT_pct": 8.47,
      "MS_pct": 7.1,
      "INF_pct": 9.8,
      "velocity": 4.5,
      "ATT_delta": 3.2
    }
  ]
}

GET /v1/token/[symbol] $0.50 ▼

full attention + price profile for a single token — e.g. /v1/token/BNKR

response fields

ATT_pct velocity ATT_delta_1h ATT_delta_4h price price_change_1h divergence narrative_summary spike_history

GET /v1/spikes $0.05 ▼

recently confirmed attention spikes with narratives

response fields

symbol velocity confidence signal_type narrative_summary price_at_post timestamp

GET /v1/bankr $0.05 ▼

competitive intelligence for bankr agents — leaderboard + growth metrics. data computed fresh from DB on every request (1-2s response).

query params

param	values	default
?hours=	1 / 2 / 4 / 8 / 12 / 24	4
?sort_by=	ATT_pct \| ATT_delta \| velocity	ATT_pct

response fields

window_hours data_age_minutes ATT_pct ATT_base ATT_delta velocity mentions_Nh unique_authors rank top_gainers top_losers total_attention_share

example response

{
  "updated_at": "2026-03-14T20:15:41Z",
  "data_age_minutes": 0.0,
  "window_hours": 4,

  "total_attention_share": 25.0,
  "leaderboard": [
    {
      "symbol": "felix",
      "ATT_pct": 27.2,
      "ATT_base": 4.2,
      "ATT_delta": 0.7,
      "velocity": 0.0,
      "mentions_4h": 9,
      "unique_authors": 8,
      "rank": 10
    }
  ],
  "top_gainers": [
    { "symbol": "felix", "delta": 0.7 }
  ]
}

GET /v1/rotation $0.10 ▼

directed creator rotation graph with confirmed ATT growth. by default, only returns tokens where inflow converted to attention increase. quality-filtered: engagement floor, view fraud detection, scanner exclusion.

query params

param	values	default
?window=	1h \| 4h	4h
?limit=	1 – 25	10
?confirmed_only=	true \| false	true

response fields

edges[] nodes[] from to weight top_creator max_likes inflow outflow net_flow ATT_growth post_count

example response

{
  "window": "4h",
  "edges": [
    {
      "from": "INSTACLAW",
      "to": "ODAI",
      "weight": 1,
      "top_creator": {
          "username": "@thebasedfrogx",
          "followers": 2486,
          "max_likes": 11
      }
    }
  ],
  "nodes": [
    {
      "symbol": "ODAI",
      "inflow": 1,
      "outflow": 0,
      "post_count": 18,
      "net_flow": 1,
      "ATT_growth": 34.2
    }
  ]
}

quickstart

from x402.http import x402_client
import httpx

client = x402_client(
    private_key="0xYOUR_KEY",
    httpx_client=httpx.Client()
)

resp = client.get("https://api.checkr.social/v1/leaderboard")
print(resp.json())

# check API status (free)
curl https://api.checkr.social/health

# paid endpoints require x402 payment headers
# use an x402-compatible client (Python SDK or similar)