Skip to main content
The Bitrace AML API provides comprehensive blockchain analytics capabilities through two main services:

​
KYA (Know Your Address)

KYA endpoints allow you to analyze blockchain addresses and gather intelligence about entities, risks, and behaviors.

​
Core Endpoints

  • Retrieve Entity - Identify the entity behind an address
  • Retrieve Risk Assessment - Get detailed risk information
  • Retrieve Risk Score - Get numerical system risk scores or custom risk scores
  • Retrieve Entity and Risk - Combined entity and risk data
  • Bulk Operations - Query multiple addresses in a single request

​
Use Cases

  • Compliance Screening: Check addresses before onboarding
  • Risk Assessment: Evaluate counterparty risk
  • Entity Investigation: Understand who owns an address
  • Portfolio Analysis: Analyze multiple addresses at once

​
KYT (Know Your Transaction)

KYT endpoints help you screen transactions for potential risks by analyzing the entire transaction chain.

​
Core Endpoints

  • Retrieve Transaction Risks - Screen transactions for risk indicators
  • Retrieve Custom Risk Score - Calculate custom risk scores based on your rules

​
Use Cases

  • Transaction Monitoring: Real-time risk screening
  • Compliance: Ensure transactions meet compliance requirements
  • Risk Management: Identify potentially risky transactions
  • Investigation: Deep dive into transaction patterns

​
Base URL

All API requests use the following base URL: 
https://api.bitrace.io

​
Authentication

All endpoints require authentication via the X-Access-Key header. See Authentication for details.

​
Response Format

All API responses follow a consistent format: 
{
  "success": boolean,
  "code": number,
  "status": "string",
  "msg": "string",
  "data": object
}

​
Response Fields

​
success
boolean
required
Request success or not
​
code
number
required
  • 1 - success
  • Other numbers, HTTP status code or custom error code, see error codes
​
msg
string
required
SUCCESS or error message
​
data
object | array
required
The response payload (varies by endpoint) when response 2xx
​
error
object
The error object when response 4xx or 5xx

​
Versioning

The current API version is v1. All endpoints include /api/v1/ in the path.

​
Rate Limits

API rate limits are based on your subscription plan. Check your dashboard for specific limits.
Explore the endpoints: Select KYA or KYT from the sidebar to see detailed endpoint documentation.