Skip to main content
GET
Token intel — dashboard summary

Authorizations

X-API-Key
string
header
required

Preferred for swaps-api endpoints (/swaps/*, /stats/*, /trending, /pool-events).

Path Parameters

mint
string
required

Response

Token intel

Aggregated intelligence for one token mint: actor aggregates, holders, price/volume trend, dev concentration, and an embedded Risk Score summary. Cached server-side ~60s, unless a read failed (see unavailable).

Full per-actor lists live at dedicated endpoints (e.g. /tokens/{mint}/snipers); the actors object here carries counts + concentration percentages with fetch_url deep-links.

unavailable
enum<string>[]
required

Always present. The fields whose read FAILED on this request (a database error or timeout): each is null (for top10_pct, status: computing) and is a transient error, not an absence of data. [] means every read succeeded. A null that is NOT listed here means the data does not exist (no curve, no pair, not yet computed).

A response with anything in unavailable, or in risk.unavailable_signals, is sent Cache-Control: no-store and is not cached at the origin: retry it.

Available options:
dev,
change_pct,
bonding_pct,
liquidity_usd,
volume_24h_usd,
volume_pct_change_24h,
creator_held_pct,
holders_count,
dev_held_lp_pct,
top10_pct,
actors
mint
string
computed_at
integer

Unix epoch milliseconds.

holders_count
integer | null

Distinct wallets currently holding non-zero balance. null unless the mint has a complete holder census; holder_data_status says why.

holder_data_status
enum<string>

Whether the holder-derived fields (holders_count, creator_held_pct, top10_pct and each actors entry's pct_of_circulating) come from a complete holder census. This field is carried by /tokens/{mint}/intel only. top10_pct.status is a different field with its own values (see Top10Pct).

  • ok: they do.
  • partial_holder_data: the mint has no complete census: it has never had one, or the last one missed holders. Those fields are null. An actors entry's count is still served, counted over the holder rows available. A mint with no holder rows yet and no census also reads partial_holder_data here, while its top10_pct.status is no_holder_data until the first rows arrive.
  • census_refused: the census source refused the mint (too many accounts to scan). Those fields are null, and a census does not complete on its own; this is not transient.
  • unavailable: a read FAILED, so holders_count is null and named in unavailable. If it was the census check that failed, creator_held_pct and top10_pct are also null and named in unavailable, and each actors entry's pct_of_circulating is null. Retry.
Available options:
ok,
partial_holder_data,
census_refused,
unavailable
creator_held_pct
number | null

Percent of supply still held by the creator wallet (0–100). null unless the mint has a complete holder census (see holder_data_status), and when the supply or the creator is unknown.

bonding_pct
number | null

Pump.fun bonding-curve progress, or null. Three outcomes, not two:

  • 0–100 — the mint is still on the pump.fun bonding curve. Progress is real_sol_reserves / 85 SOL × 100, taken from the mint's most recent trade, when that trade is on pump.fun, and clamped to 0–100.
  • 100.0 — the mint has graduated off the curve; its most recent trade was on PumpSwap, Raydium or another venue. Graduated mints deliberately read 100.0, not null (Dexploit-Swaps#951).
  • null — the mint's address does not end in pump, or its most recent trade in the last 24 hours, on any venue, reported zero SOL reserves, or it has not traded in the last 24 hours. A graduated mint that has gone quiet for a day therefore reads null rather than 100.0, so null does not by itself mean "not a pump.fun token".
top10_pct
object

Never null. On /intel, status is computing only when the read FAILED, and "top10_pct" is then in unavailable. Data that isn't available yet is no_holder_data. The computing status described on Top10Pct (transient, such as a backfill running) applies to /tokens/{mint}/audit and /tokens/{mint}/concentration, not to /intel.

actors
object | null

Actor aggregates. {} when there is genuinely nothing to report; null only when the read FAILED, in which case "actors" is in unavailable.

dev
object | null

Creator wallet, source provenance, and recent launches. null when the creator is unknown (Phase 0 strict precedence — never falls back to largest holder). Also null when any of its reads failed; then "dev" is in unavailable (it used to be served as a first-time creator: other_tokens: [], total_launches: 0).

change_pct
object | null

Price change percent across canonical windows. {} when the token has no pair or candles; null only when the read FAILED, in which case "change_pct" is in unavailable.

liquidity_usd
number | null
volume_24h_usd
number | null
volume_pct_change_24h
number | null
dev_held_lp_pct
number | null

Percent of LP tokens still held by the creator (when LP is not burnt).

risk
object

Slim Risk Score summary embedded in /intel. Full per-signal breakdown at /tokens/{mint}/risk.