Getting started
API Billing Guide
⏳ Synchronous APIs
Billing Rules Overview:
- Single Call 🎯: 1 charge per valid address; no charge for repeats within 7 days (exceptions apply)
- Bulk Call ⏩: Charged per valid address; no charge for repeats within 7 days
🎯 Single Calls
| Endpoint | Description | Billing | Billing Details |
|---|---|---|---|
🔵 GET /api/v1/tracker/kya/entities | Get entity info by address | 1 | No charge for repeats within 7 days |
🔵 GET /api/v1/tracker/kya/risks | Get risk info by address | 1 | No charge for repeats within 7 days |
🔵 GET /api/v1/tracker/kya/entities-risks | Get entity & risk info | 1 | No charge for repeats within 7 days |
🔵 GET /api/v1/tracker/kya/risk-scores | Get risk score | 1 | No charge for repeats within 7 days |
🔵 GET /api/v1/tracker/kya/address/basic | Get basic address info | 1 | No 7-day exemption; repeats still charged |
🔵 GET /api/v1/tracker/kya/address/counterparties | Get top N counterparties (1-hop) | 1 | No charge for repeats in 7 days; counts as 1 even with multiple addresses |
⏩ Bulk Calls
| Endpoint | Description | Billing | Billing Details |
|---|---|---|---|
🟠 POST /api/v1/tracker/kya/entities | Bulk get entity info | N | N = valid addresses; excludes 7-day repeats |
🟠 POST /api/v1/tracker/kya/risks | Bulk get risk info | N | N = valid addresses; excludes 7-day repeats |
🟠 POST /api/v1/tracker/kya/entities-risks | Bulk get entity & risk info | N | N = valid addresses; excludes 7-day repeats |
🟠 POST /api/v1/tracker/kya/risk-scores | Bulk get risk scores | N | N = valid addresses; excludes 7-day repeats |
🚀 Asynchronous APIs
Billing Rules Overview:
- Async Call 🎯: Charged when the request is created; callback is free
- No bulk APIs: All are single-call mode
- Special Note: Depth-supported endpoints (e.g.,
Retrieve Transaction Risks) are also charged at creation
🎯 Single Calls
| Endpoint | Description | Billing | Billing Details |
|---|---|---|---|
🟠 POST /api/v1/tracker/kya/custom-risk-scores | Custom address risk score (async) | 1 | Charged at creation; callback free |
🟠 POST /api/v1/tracker/kya/tags-and-scores | Combined address info (entity, risk, score) | 1 | Charged at creation; callback free |
🟠 POST /api/v1/tracker/kyt/transfers/risk-screening | Transaction risk screening (depth 0–6) | 1 | Charged at creation; callback free |
🟠 POST /api/v1/tracker/kyt/custom-risk-scores | Custom transaction risk score (async) | 1 | Charged at creation; callback free |