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: Bearer or x-api-key header
Format
JSON. Every endpoint is a GET
Live
The same events arrive in real time on the streams

Endpoints

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 next value from the previous response. Keep passing it until next is null. A cursor only works on the endpoint that issued it.
from / to
The time range, as ISO-8601 or Unix milliseconds. There is no since slot 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. Narrow from / to or 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; source for one)
Token trades, wallet trades, creations, graduations.
mints (up to 100; mint for 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 sources name must be a documented source; an unknown name returns 400. Send sources or source, not both; likewise mints or mint. All sources
  • Size bounds use the USD value stored with each row. A set bound excludes rows with volumeUsd: null, and minVolumeUsd must not be above maxVolumeUsd.
  • 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

400invalid_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).
401unauthorized
Missing or invalid API key.
404not_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.
429rate_limited
Per-key burst limit exceeded.
429quota_exceeded
Per-user monthly request quota exceeded.
500internal
Unexpected server failure.
503upstream_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.

Download collectionDownload environment

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