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

Entity intelligence

Access entity profiles, labels, and wallet clustering to understand how desks and custodians move across chains.

GET

/v1/entities/{entity_id}

Fetch entity profile, labels, and wallet clusters.

entity_id

string

Entity slug or UUID.

window

string

24h, 7d, 30d, 90d.

metrics

string

flows, pnl, exposures.

ReturnsEntityProfile

POST

/v1/entities/search

Search for entities by name, tag, or wallet address.

query

string

Search query.

limit

number

Max results (default 20).

include_labels

boolean

Include labels array.

ReturnsEntitySearchResult[]

Entity profile

GET /v1/entities/otc-bridge?window=30d

Request

curl -X GET \
  "https://api.onchainflows.io/v1/entities/otc-bridge?window=30d" \
  -H "x-ocf-key: ocf_live_xxxx" \
  -H "x-ocf-ts: 1731029871" \
  -H "x-ocf-signature: 6a13b5..."

Response

{
  "id": "entity_402a",
  "name": "OTC Bridge",
  "labels": ["otc", "institutional"],
  "confidence": 0.88,
  "flows": {
    "inflows_usd": 642100000,
    "outflows_usd": 590200000,
    "net_flow_usd": 51900000
  }
}

Entity search

POST /v1/entities/search

Request

curl -X POST \
  "https://api.onchainflows.io/v1/entities/search" \
  -H "x-ocf-key: ocf_live_xxxx" \
  -H "x-ocf-ts: 1731029871" \
  -H "x-ocf-signature: 61cc23..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Wintermute",
    "limit": 5,
    "include_labels": true
  }'

Response

{
  "count": 1,
  "data": [{ "id": "entity_77f2", "name": "Wintermute" }]
}

Need help?

Schedule a 15-minute integration session with our team.