REST API
The Anaxer REST API returns Solana token metadata, prices, trades, wallet transfers, launches and graduations as JSON, with 7 days of history on every plan.
- Base URL
https://api.anaxer.com- Auth
- API key in an
Authorization: Bearerorx-api-keyheader - Format
- JSON. Every endpoint is a
GET - Live
- The same events arrive in real time on the streams
Endpoints
11 endpoints in four groups.
Tokens
- GET/v1/tokens/:mintName, symbol, supply and socials for one token.
- GET/v1/tokens/batchMetadata for up to 50 tokens in one call.
- GET/v1/tokens/:mint/priceThe latest USD and SOL price and market cap for one token.
- GET/v1/tokens/batch/priceLatest prices for up to 100 tokens in one call.
- GET/v1/tokens/:mint/tradesA token's trades from the last 7 days, newest first.
Wallets
Launches
Auth
Every /v1 endpoint needs an API key, sent as Authorization: Bearer YOUR_KEY or in an x-api-key header. The health check, GET /health, needs no key. Authentication
Pagination and time windows
List endpoints return data (newest first), next and window. Batch lookups return data only.
limit- Items per page: 50 by default, 200 at most.
cursor- The
nextvalue from the previous response. Keep passing it untilnextisnull. A cursor only works on the endpoint that issued it. from/to- The time range, as ISO-8601 or Unix milliseconds. There is no
sinceslot parameter. window- In the response: the range actually searched, after clamping to the last 7 days. History is 7 days on every plan.
- Slow reads
- A list read that runs past 10 seconds is stopped and answers
503 upstream_unavailable. Narrowfrom/toor add a filter, then retry.
Filters, REST and WebSocket
List endpoints take the same filters as the matching stream, as query parameters; lists are comma-separated. A wallet or token you would filter on in a stream is the path here: /v1/tokens/:mint/trades, /v1/wallets/:wallet/trades, /v1/wallets/:wallet/transfers.
sources(up to 20;sourcefor one)- Token trades, wallet trades, creations, graduations.
mints(up to 100;mintfor one)- Wallet trades (either side of the swap) and wallet transfers. On token trades the mint is the path.
minVolumeUsd/maxVolumeUsd- Token trades, wallet trades, wallet transfers.
solOnly- Token trades, wallet trades.
direction(in/out)- Wallet transfers. On the transfers stream it needs
wallets. excludeMayhem- Creations, graduations.
minLiquiditySol- Graduations.
- Every
sourcesname must be a documented source; an unknown name returns 400. Sendsourcesorsource, not both; likewisemintsormint. All sources - Size bounds use the USD value stored with each row. A set bound excludes rows with
volumeUsd: null, andminVolumeUsdmust not be abovemaxVolumeUsd. - Batch prices take up to 100 mints, as the prices stream does; batch metadata takes up to 50.
Strict parameters
Query parameters are checked. A parameter an endpoint doesn't take returns 400 invalid_request, naming it and listing the allowed ones, instead of being ignored and returning unfiltered data.
Errors
Errors have an HTTP status and a JSON body with a machine-readable code and a message. Error handling
- 400
invalid_request - Bad mint, wallet, param value, source name, batch size, or cursor, or a query parameter the endpoint doesn't take (the message names it and lists the allowed ones).
- 401
unauthorized - Missing or invalid API key.
- 404
not_found - Unknown token, or no price for the mint (never priced, or no trade in the last 72 hours). An unknown wallet is not an error: it returns 200 with an empty list.
- 429
rate_limited - Per-key burst limit exceeded.
- 429
quota_exceeded - Per-user monthly request quota exceeded.
- 500
internal - Unexpected server failure.
- 503
upstream_unavailable - Dependency unavailable (e.g. metadata resolve), or a list read that ran past 10 seconds: narrow from / to and retry.
Postman collection
Every REST endpoint plus the /v1/stream WebSocket, ready to import. Load the environment, paste your key into the apiKey variable, and send. Optional filters ship disabled, so tick the ones you want. The WebSocket request needs the Postman desktop app; the web client cannot open WebSocket connections.
Common questions
How far back does the Anaxer REST API go?
List endpoints return the last 7 days on every plan: token trades, wallet trades, wallet transfers, creations and graduations. Prices are the latest only, and token metadata has no time limit.
How do I page through REST results?
Every list response includes next, an opaque cursor. Pass it as cursor to get the following page and stop when next is null. A page holds 50 items by default and up to 200.
What happens if I send a query parameter an endpoint doesn't take?
The Anaxer REST API answers 400 invalid_request, naming the parameter and listing the ones the endpoint allows. It never ignores an unknown parameter.
Last updated · Changelog