API Billing Guide - Bitrace Documents

⏳ 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

Last modified on August 9, 2025