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.

Spec: OpenAPI 3.1 (206 paths, 224 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.

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.

Matches live tools/list. Schema for each tool returned by tools/list.

RAG / NL (2) — ask_blockchain, search_rag
Block / tx data (3) — query_blocks, query_transactions, inspect_block
RPC (7) — rpc_get_balance, rpc_get_block, rpc_get_transaction, rpc_get_logs, rpc_trace_transaction, rpc_read_contract, rpc_get_contract_info
Whales / entity (5) — get_whale_activity, get_btc_flows, get_smart_wallets, get_entity_activity, get_wallet_profile
Market (5) — get_emerging_tokens, get_trending_tokens, get_token_flows, get_exchange_flows, get_price_history
Signals (9) — get_trade_signals, get_intelligence_feed, get_alarm_feed, get_alerts, get_alarm_categories, get_conviction_signals, get_predictions, get_signal_accuracy, get_signal_history
Behavioral (3) — get_cross_chain_signals, get_intent_detections, get_mev_leaderboard
Hyperliquid perps (5) — get_hl_market, get_hl_traders, get_hl_funding_arbs, get_hl_liquidation_heatmap, get_hl_copy_trade_alerts
Forensic (8) — screen_address, assess_risk, detect_mixer_interactions, check_abuse_status, trace_flows, generate_compliance_report, export_compliance_pdf, get_risk_briefing
Compliance monitoring (3) — monitor_address, list_retroactive_alerts, dismiss_retroactive_alert
KYA agent identity (4) — register_agent_identity, validate_agent_action, revoke_agent_identity, list_my_agent_identities
Pipeline / system (7) — get_network_summary, get_system_status, get_chain_status, get_pipeline_status, get_health, get_logs, get_stats

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 68 MCP tools, 90-day key) · Pro ($99/mo, 600 req/min, 1,000,000/day, managed chat, OAuth, dashboards, named keys) · Enterprise (custom — sales-led).
Errors: 401 AUTH_REQUIRED, 401 AUTH_INVALID, 403 (tier), 429 (rate limit).

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.