Watched addresses
Transfers
Unknown addresses are queued and resolved within seconds.
This key is shown only once. Store it somewhere safe.
Authentication
All /v1 endpoints require a key, except
/v1/health. Create one in the API keys tab.
x-api-key: ok_xxxxxxxxxxxx
Base URL:
Responses are asynchronous
An address already on record returns 200. A new one returns 202, goes into the queue, and should be polled again a few seconds later. Labeling takes several seconds per address and is rate limited, so a synchronous response is not possible.
Statuses
| labeled | The address is known and attributed |
| unlabeled | Resolved cleanly but no label exists — unknown address |
| pending | Queued, not resolved yet |
| failed | Could not resolve — we do not know. This is not the same as unlabeled and must never be read as clearing the address. |
Notes
- Every response carries
checked_at. Labels change over time; what matters for audit is when the assessment was made. - The
Sanctiontag is an attribution from our data provider, not an official OFAC listing. Verify independently before acting on it legally. Exchange Usermeans the address is attributed to a customer of that exchange — an attribution, not a certainty.- Default rate limit is 120 requests per minute per key. Exceeding it returns
429with aretry-afterheader. - Transaction lookup supports
bscandtrononly.