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

Webhooks

Stream flow alerts to your system with signed webhook payloads. Define filters per chain, entity type, and confidence score.

Alert types

Whale inflow/outflow spikes
Entity-to-entity transfers
Stablecoin rotations

Delivery settings

Retry backoff with signature verification
Custom thresholds per chain
Slack + PagerDuty routing

Create webhook

POST /v1/webhooks

Request

curl -X POST \
  "https://api.onchainflows.io/v1/webhooks" \
  -H "x-ocf-key: ocf_live_xxxx" \
  -H "x-ocf-ts: 1731029871" \
  -H "x-ocf-signature: 4f9d10..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hooks.yourapp.com/ocf",
    "events": ["whale_transfer", "rotation_signal"],
    "filters": { "chain": ["eth", "btc"], "min_value": 25000000 }
  }'

Response

{
  "id": "wh_91b4",
  "status": "active",
  "events": ["whale_transfer", "rotation_signal"]
}

Webhook payload

POST https://hooks.yourapp.com/ocf

Request

POST /ocf
X-OCF-Signature: 89af...

{
  "event": "whale_transfer",
  "id": "flow_8b1d",
  "chain": "ethereum",
  "value_usd": 184200000,
  "confidence": 0.91,
  "timestamp": "2024-11-07T18:04:21Z"
}

Response

HTTP/2 200
{ "received": true }

Need help?

Schedule a 15-minute integration session with our team.