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

Authentication

Authenticate using an API key with HMAC signing. Include the key in the x-ocf-key header and send a unix timestamp in x-ocf-ts.

Signature format

HMAC-SHA256 of METHOD + PATH + TIMESTAMP.

Header: x-ocf-signature

Signed request

GET /v1/flows/whales

Request

curl -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: f9b4de..."

Response

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

Signature mismatch

401 Unauthorized

Request

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

Response

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

Need help?

Schedule a 15-minute integration session with our team.