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

Rate limits

Limits are enforced per workspace key and reset on a rolling window. Burst traffic is smoothed automatically to protect latency.

120

requests per minute

Burst up to 240 with smoothing.

stream connections

Per workspace key.

30d

default archive window

Extend with Research tier.

Rate limit headers

GET /v1/flows/whales

Request

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

Response

HTTP/2 200
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 78
X-RateLimit-Reset: 1731029930

{
  "count": 1,
  "data": [{ "id": "flow_8b1d" }]
}

Limit exceeded

429 Too Many Requests

Request

curl -i -X GET \
  "https://api.onchainflows.io/v1/entities/search" \
  -H "x-ocf-key: ocf_live_xxxx" \
  -H "x-ocf-ts: 1731029871" \
  -H "x-ocf-signature: 91c4e2..."

Response

HTTP/2 429
Retry-After: 24

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Retry after 24s."
  }
}

Need help?

Schedule a 15-minute integration session with our team.