Atlas API Overview

The Atlas API provides historical and real-time snapshots of token holder relationships. Each snapshot captures every top holder address, their balance, and the on-chain links between wallets (funding flows, transfers).

Note: Distribution metrics, sniper tracking, and cluster analysis have moved to the DEX Metrics API. The legacy paths under /atlas/v1/.../metrics/... still work but are deprecated.

Base Path

/atlas/v1

Endpoints

Endpoint	Description
`GET /{network}/{token_address}/snapshots`	List all available snapshot timestamps for a token
`GET /{network}/{token_address}/snapshots/latest`	Retrieve the most recent full snapshot
`GET /{network}/{token_address}/snapshots/{timestamp}`	Retrieve a specific snapshot by timestamp

List Snapshots

GET /atlas/v1/{network}/{token_address}/snapshots

Returns a list of available snapshot timestamps. Use these timestamps to retrieve specific historical snapshots.

Response:

{
  "snapshots": [1700000000, 1700003600, 1700007200]
}

Latest Snapshot

GET /atlas/v1/{network}/{token_address}/snapshots/latest

Returns the most recent full snapshot, including all holder nodes, links between them, token metadata, and currency data. This is the richest data endpoint -- use it when you need the complete holder map.

Snapshot by Timestamp

GET /atlas/v1/{network}/{token_address}/snapshots/{timestamp}

Returns the snapshot data for a specific historical timestamp. The timestamp must match one of the values returned by the list endpoint.