Documentation | Bitpoort

Quick start

Get a key — POST https://api.bitpoort.com/v1/keys returns a free bp_ key (no signup, 50 keys/IP/day cap, 90-day expiry).
Make your first call — curl -H "X-API-Key: bp_..." "https://api.bitpoort.com/v1/whales/recent?chain=ETH&limit=3".
Plug into MCP — point your client at https://mcp.bitpoort.com/ with header X-API-Key. Paste-ready configs at /agents.md.

REST API

Spec: OpenAPI 3.1 (270 paths, 302 operations) — public, no auth.
UI: ReDoc — public, no auth.
Summary: /openapi-summary.json — counts + canonical URLs in one JSON.
Auth: most endpoints take X-API-Key (alternative: Authorization: Bearer). Public endpoints carry security: [] per-route in the spec.
Filters / pagination: hot list endpoints share chain, limit, min_usd, since, until, opaque cursor; responses include next_cursor + has_more.
Errors: structured {"error":{"code":..,"message":..,"hint":..,"docs":..}} for auth, 404, validation, cursor.

MCP server

Endpoint: https://mcp.bitpoort.com/ (Streamable HTTP, JSON-RPC over POST).
Discovery manifest: /.well-known/mcp.json — endpoint, transport, auth, tool count, chains, sanctions sources.
Setup snippets: /agents (HTML) or /agents.md (markdown) — copy-paste config for Claude Desktop, Claude Code, Cursor, VS Code, Codex / OpenClaw, Anthropic SDK, OpenAI Agents SDK, plus plain JSON-RPC curl.
Tool aliases: common guesses (network_status, recent_whales, emerging_tokens) resolve transparently to canonical tool names.

Tools — all 80 MCP tools, 12 lanes

The live catalog (names + schemas) is returned by tools/list on the MCP endpoint; the same list with usage notes is at /agents.md. Lanes: RAG / natural language · block & tx data · raw RPC (own archive nodes) · whales / entities · market · signals · behavioral · Hyperliquid perps · forensic & compliance (sanctions + PEP screening, mixer detection, flow tracing, signed compliance reports re-verifiable at the public verify endpoint) · compliance monitoring · agent identity (KYA) · system.

Authentication

Most endpoints require X-API-Key: bp_... (or Authorization: Bearer bp_...).
Public endpoints (no key needed): /v1/keys, /v1/health, /health, /v1/trust, /v1/whales/recent, /v1/feed/emerging-tokens, /openapi.json, /openapi-summary.json, /redoc.
Tiers: Free (60 req/min, 10,000/day, all 80 MCP tools, 90-day key) · Pro ($100/mo, 600 req/min, 1,000,000/day, managed chat, OAuth, dashboards, named keys) · Compliance ($1,000/mo, signed reports + monitoring) · Enterprise (custom — sales-led).
Errors: 401 AUTH_REQUIRED, 401 AUTH_INVALID, 403 (tier), 429 (rate limit).

Attestation & reproducibility

Every signed compliance report embeds attestation.signature (HMAC-SHA256), git_commit, alembic_head, the shared eval_baseline (97.5% tool selection accuracy across 68 evaluated tools and 3 models (Haiku 4.5, GPT-4o-mini, Sonnet 4.6), 0 invariant violations, 828 regression tests), and data_provenance counts pinned at generation.
Verify a report: GET https://api.bitpoort.com/v1/verify/<content_hash> (public, no auth).
Live methodology: /v1/trust · full walkthrough at /attestation.