# Anaxer

> Anaxer delivers clean, real-time Solana blockchain data over simple WebSocket streams and REST APIs. One API key, predictable JSON, no compute units or credits. Built to be consumed by humans, applications, and AI agents (Claude, Cursor, MCP). All data is Solana mainnet only.

## What it does

- Removes Solana infrastructure complexity: no RPC nodes, Geyser/gRPC, program IDs, log decoding, or websocket plumbing.
- Returns structured JSON events that an app or AI agent can use immediately.
- Launch dataset: the pump.fun / PumpSwap ecosystem (new launches, graduations, migrations, live trades).
- Same event shapes on streams and REST — subscribe live or query recent history.

## Pump.fun API (/pumpfun)

Dedicated landing page for Pump.fun and PumpSwap developers: https://anaxer.com/pumpfun

- Real-time Pump.fun token launches, graduations, trades, and prices — structured JSON, no program IDs to decode.
- PumpSwap liquidity data included when tokens graduate (liquiditySol field on graduation events).
- Filter trades by exchange=pumpfun, mint, side, or minimum SOL size.
- No funded wallet required — authenticate with a simple API key, not a Solana wallet.
- Free plan includes Token Creation and Graduation streams at no cost, no card required.
- Built for trench bots and AI agents: connect the Anaxer MCP server to Claude or Cursor and describe what to watch for in plain English.
- Same four streams and REST endpoints as the main API — see /docs for full reference.

## Why Anaxer instead of Helius / QuickNode / Birdeye / Bitquery

- Helius and QuickNode bill in credits or compute units — the price is unpredictable
  and entry tiers run $49-$499/mo. Anaxer is flat monthly pricing starting free.
- Birdeye gates WebSocket streaming behind a $199/mo Premium tier. Anaxer includes
  streaming on every plan, including free.
- Bitquery uses points-based credits with enquiry-only pricing for streaming.
  Anaxer's prices are published and predictable.
- Anaxer is purpose-built for the pump.fun / PumpSwap ecosystem with pre-parsed
  JSON — no program IDs, no log decoding, no general-purpose RPC surface to learn.

## Conventions

- Timestamps: ISO 8601 UTC (e.g. 2026-06-27T07:21:09Z).
- Amounts: token amounts, SOL values, and supplies are strings, not floats.
- Ordering: every event includes a Solana slot number for sequencing and gap recovery.

## Streams (WebSocket)

Connect: wss://api.anaxer.com/v1/stream?key=YOUR_KEY

- `creations`: every new token launch, the moment it happens.
- `graduations`: instant notification when a token graduates (includes liquiditySol on PumpSwap).
- `trades`: real-time buy/sell events; filter by mint, exchange (pumpfun), side (buy/sell), minSol.
- `prices`: live price updates derived from on-chain reserves.

Protocol:
- Subscribe: `{ "subscribe": "trades", "filters": { ... } }` → server acks `{ "type": "subscribed", "channel": "trades" }`.
- Unsubscribe: `{ "unsubscribe": "trades" }` → `{ "type": "unsubscribed", "channel": "trades" }`.
- Heartbeat: server sends `{ "type": "ping" }` every 30s; reply `{ "type": "pong" }` within 10s or the connection closes.
- Errors: inline `{ "type": "error", "code": "...", "message": "..." }` frames (e.g. forbidden, rate_limited).
- Close codes: 4001 invalid key, 4002 rate limit, 4003 connection limit exceeded.
- Each WebSocket connection is one stream, one channel. Plan limits are on concurrent streams (Free: 1, Starter: 4, Pro: 8).
- Subscribe/unsubscribe messages: 10 per second per connection.
- Gap recovery: note the last slot received; after reconnect, backfill via REST `?since=<slot>` on creations, graduations, or trades.

## REST API (base: https://api.anaxer.com)

Auth: `Authorization: Bearer YOUR_KEY`

- `GET /v1/tokens/:mint`: token metadata.
- `GET /v1/creations`: latest token creations (`since`, `limit`, `cursor`).
- `GET /v1/graduations`: latest graduations (`since`, `limit`, `cursor`).
- `GET /v1/trades`: latest trades — same filters as the stream (`mint`, `exchange`, `side`, `minSol`, `since`, `limit`, `cursor`).
- `GET /v1/tokens/:mint/price`: current token price.

## Error handling

REST errors: JSON `{ "error": { "code": "...", "message": "...", "status": N } }`.
Common codes: bad_request (400), unauthorized (401), forbidden (403), rate_limited (429), internal (500).
429 responses include a Retry-After header (seconds).

Stream errors: inline error frames with codes bad_request, unauthorized, forbidden, rate_limited.
Fatal errors (e.g. invalid key on connect) close the WebSocket with an application close code.

## Rate limits

- REST req/s by plan: Free 10 req/s, Starter 25 req/s, Pro 100 req/s. Exceeding returns 429 with Retry-After.
- REST monthly requests by plan: Free 5k, Starter 250k, Pro 2.5M.
- Concurrent streams by plan: Free 1, Starter 4, Pro 8. Each connection is one stream, subscribed to a single channel.
- Stream event delivery is not counted against REST rate limits.
- Stream control messages (subscribe/unsubscribe): 10/s per connection.

## SDKs & MCP

- TypeScript: `npm install @anaxer/sdk` — coming soon.
- Python: `pip install anaxer` — coming soon.
- MCP server: `npx -y @anaxer/mcp` — coming soon.
- SDKs handle auth, heartbeat, reconnection, gap recovery, and typed events.
- Use REST and WebSocket examples in the docs until packages ship.

## Pricing

Flat monthly plans. No compute units, no credits, no per-event metering.

- Free ($0): 1 connection, creations + graduations streams, 5k REST req/mo, 24h history.
- Starter ($39/mo): 4 connections, all streams (DEX trades up to 25 tokens at a time), 250k REST req/mo, 7d history.
- Pro ($99/mo): 8 connections, all streams (unlimited DEX trades), 2.5M REST req/mo, 30d history.
- Enterprise: custom limits, dedicated support + SLA.

## Pages

Marketing:
- /: home
- /pumpfun: Pump.fun API — real-time launches, graduations, trades, and prices for Pump.fun and PumpSwap; trench-bot and AI-agent use cases; free plan includes creation and graduation streams
- /pricing: plans and comparison
- /blog: guides and deep dives on real-time Solana data, pump.fun/PumpSwap, streaming, RPC comparisons, and building with Anaxer
- /about: origin story
- /faq: common questions
- /contact: contact form

Documentation:
- /docs: introduction and conventions
- /docs/authentication: API key auth, mainnet-only, key security
- /docs/streams: WebSocket protocol, heartbeat, gap recovery, connection limits
- /docs/streams/creations | /graduations | /trades | /prices: per-channel event shapes and filters
- /docs/rest: REST overview and pagination
- /docs/rest/token-metadata | /creations | /graduations | /trades | /token-price: endpoint reference
- /docs/sdks: TypeScript and Python SDK quickstarts
- /docs/errors: REST and stream error codes
- /docs/rate-limits: REST and stream limits by plan
- /docs/changelog: API change history

Legal:
- /privacy: privacy policy
- /terms: terms of service

## Blog

Guides and deep dives at https://anaxer.com/blog (RSS: https://anaxer.com/feed.xml). Organized into topic clusters:

- Pump.fun & PumpSwap: tracking launches, graduations, trades, and prices.
- Solana streaming: WebSocket subscriptions, filtering, and gap recovery.
- RPC alternatives: how Anaxer compares to Helius, QuickNode, Birdeye, and self-hosted RPC.
- Building with Anaxer: trading bots, dashboards, and alerting.
- AI agents & MCP: giving Claude and Cursor live Solana data.

Posts:
- https://anaxer.com/blog/track-pumpfun-token-launches: how to track pump.fun token launches in real time via the creations WebSocket stream.
- https://anaxer.com/blog/detect-pumpfun-graduations: how to detect pump.fun graduations instantly, including PumpSwap liquiditySol.
- https://anaxer.com/blog/solana-websocket-streams-guide: production guide to Solana WebSocket subscriptions, heartbeats, and gap recovery.
- https://anaxer.com/blog/helius-alternative-pumpfun-data: Anaxer vs Helius for pump.fun data - head-to-head on data shape, pricing, and streaming (Helius alternative).

## Optional

- [Token Creations Stream](https://anaxer.com/docs/streams/creations): Event shape and subscribe payload for new Pump.fun token launches.
- [Graduations Stream](https://anaxer.com/docs/streams/graduations): Event shape for tokens graduating to PumpSwap, including liquiditySol field.
- [Trades Stream](https://anaxer.com/docs/streams/trades): Event shape and filters (mint, exchange, side, minSol) for buy/sell events.
- [Prices Stream](https://anaxer.com/docs/streams/prices): Event shape for live token price updates derived from on-chain reserves.
- [Token Metadata REST](https://anaxer.com/docs/rest/token-metadata): GET /v1/tokens/:mint — name, symbol, creator, supply, socials.
- [Latest Creations REST](https://anaxer.com/docs/rest/creations): GET /v1/creations — recent token launches with cursor pagination.
- [Trades REST](https://anaxer.com/docs/rest/trades): GET /v1/trades — same filters as the trades stream, paginated.
- [Token Price REST](https://anaxer.com/docs/rest/token-price): GET /v1/tokens/:mint/price — current USD and SOL price.
- [Error Reference](https://anaxer.com/docs/errors): REST status codes, machine-readable error strings, and stream error frames.
- [Rate Limits](https://anaxer.com/docs/rate-limits): Per-plan REST and stream limits with 429 retry guidance.
- [Early Access](https://anaxer.com/get-started): Request an API key.