> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bitrace.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 |