Token Forensics

Venum's token-forensics endpoints give you the building blocks for on-chain token intelligence — holder discovery, mint security, wallet history, and funding relationships — without standing up your own indexer.

Typical uses: holder-concentration analysis, wash-trading and bundle detection, sniper and coordinated-entry detection (shared first-funders across top holders), and fresh-launch risk checks.

Paid only — Starter tier and above. See the API reference for full request/response detail.

The endpoints

Endpoint	What it answers
GET /v1/forensics/token/:mint/asset	What is this token? Metadata + mint security (mint/freeze authority revoked?) + authoritative supply
GET /v1/forensics/token/:mint/holders	Who holds it? Full, paginated holder list
GET /v1/forensics/address/:address/transactions	What has this wallet done? History, optionally with decoded detail
GET /v1/forensics/address/:address/first-funder	Who funded this wallet first?
GET /v1/forensics/token/:mint/scan	All of the above for the top holders, in one call

Fastest path: one call

/scan does the common fan-out for you — top holders by balance, each resolved to its owner wallet and its first funder:

curl 'https://api.venum.dev/v1/forensics/token/<MINT>/scan?holders=20' \
  -H 'x-api-key: YOUR_API_KEY'

Coordinated entry shows up directly: if several of the top holders share the same firstFunder, they were likely funded from one source.

Build-your-own flow

For deeper analysis, compose the primitives:

1. Profile the token — /token/:mint/asset. Check security.mintAuthorityRevoked / freezeAuthorityRevoked and supply.
2. Pull holders — /token/:mint/holders?page=1&limit=1000, paginating until count < limit.
3. Trace funding — /address/:owner/first-funder per holder of interest.
4. Inspect activity — /address/:address/transactions?parsed=true for decoded instructions and SOL/token balance deltas, paging with before.

Notes

• Pagination — holders page by page/cursor; history pages by before (use the returned nextBefore).
• Oldest-first — first-funder walks back to the genesis transaction for you; transactions?order=asc only reverses the current page.
• Parsed depth — transactions?parsed=true decodes up to the first 100 rows per page; paginate for deeper windows.
• Caching — metadata and first-funder are cached aggressively (first-funder is immutable once the earliest transaction is reached); holders and history use short TTLs so you see near-current state.
• Rate limits — the forensics bucket: Starter 60/min, Growth 150/min, Pro 300/min.