OnChainFlows API

Build custom alerts, dashboards, and research pipelines with raw on-chain flow intelligence. Every endpoint returns normalized flow data with entity labels, confidence scores, and chain context.

12chains supported

350msmedian response time

99.98%uptime SLA

Quickstart

Create an API key in your workspace.
Whitelist your origin or server IP.
Send a signed request to /v1/flows/whales.

Base URLhttps://api.onchainflows.io

Error handling

Errors return a consistent JSON payload with a code, message, and a recommended retry strategy.

401

Unauthorized

The API key or signature is invalid or missing.

404

Not found

The requested resource or flow_id does not exist.

429

Rate limit reached

Too many requests. Retry after the window resets.

503

Upstream delay

Indexers are catching up. Safe to retry in 30 seconds.

Unauthorized

401 Unauthorized

Request

curl -X GET \
  "https://api.onchainflows.io/v1/flows/whales" \
  -H "x-ocf-key: invalid" \
  -H "x-ocf-ts: 1731029871" \
  -H "x-ocf-signature: invalid"

Response

{
  "error": {
    "code": "AUTH_INVALID",
    "message": "Signature mismatch.",
    "retry": "check_signature"
  }
}

Upstream delay

503 Service Unavailable

Request

curl -X GET \
  "https://api.onchainflows.io/v1/archive?chain=btc" \
  -H "x-ocf-key: ocf_live_xxxx" \
  -H "x-ocf-ts: 1731029871" \
  -H "x-ocf-signature: a8d123..."

Response

{
  "error": {
    "code": "INDEXING_DELAY",
    "message": "Indexers are catching up. Retry in 30s.",
    "retry": "30s"
  }
}

Need help?

Schedule a 15-minute integration session with our team.