Blockscout.ai
Your Cryptocurrency Attributions Partner
Attributions API
Welcome to Blockscout.ai's Attributions API. Our API provides comprehensive blockchain attribution data, enabling developers to integrate detailed insights into their applications effortlessly.
Use the interactive Swagger Docs by clicking the button below to explore available endpoints, understand request and response structures, and test API calls in real-time.
VASP Entity Explorer Data Dictionary
This section details the fields and structure for the VASP Entity Explorer.
Entity Data Dictionary Table
| Column Name | Description | Data Type | Example Values | Notes |
|---|---|---|---|---|
parent_id |
Parent entity (e.g., Block is parent of CashApp). | STRING | block_xyz | Uniquely identifies parent company. |
entity_id |
Unique identifier for the entity in the database. | STRING | cash_app | Uniquely identifies each entity. |
url |
The URL associated with the entity. | STRING | https://example.com | Ensure it is a valid URL. |
proper_name |
Official name of the entity. | STRING | Bitso, Coinbase | |
entity_type |
Type of entity (e.g., exchange, wallet, project). | STRING | Exchange, Wallet | Classifies the type of entity. |
contact_phone |
Contact phone number of the entity. | STRING | +1 800 123 4567 | International format is preferred. |
contact_address |
Physical address for contacting the entity. | STRING | 1234 Example Street, City, Country | |
contact_email |
Contact email address. | STRING | support@example.com | Use a general or support email if available. |
contact_telegram |
Telegram handle or contact link. | STRING | @example_support | Format as a Telegram handle. |
contact_twitter |
Twitter handle or link. | STRING | @example_twitter | Ensure it is a valid handle. |
logo |
Link to the logo image. | STRING | https://example.com/logo.png | Must be a direct link. |
year_founded |
The year the entity was founded. | INTEGER | 2012, 2015 | Full year format (e.g., 2022). |
social_media_profile (1–4) |
URL to social media profiles. | STRING | https://facebook.com/example | Use relevant platforms. |
description_merged |
Combined description of the entity. | STRING | "Example is a cryptocurrency exchange..." | Comprehensive background info. |
ticker |
The trading ticker symbol, if applicable. | STRING | BTC, ETH | Used in financial markets or assets. |
entity_tag1 – entity_tag6 |
Tags describing the entity's focus. | STRING | Cryptocurrency, Blockchain, Wallet... | For categorization. |
associate_country_1 – associate_country_6 |
Countries associated with the entity. | STRING | United States, UK, Australia... | Standardized country name or code. |
founders |
Names of the founders. | STRING | John Doe, Jane Smith | |
ceo |
Name of the CEO or leader. | STRING | Alice Johnson, Bob White | |
blockscout_balance_btc |
The BTC held by the company (BlockScout identified addresses). | FLOAT | 1442.23243444 | Cumulative amount identified. |
reported_balance_btc |
The BTC held by the company (self-reported). | FLOAT | 1442.23243444 | BTC as reported by the entity. |
Bitcoin Identity Attribution Data Dictionary
This section details the fields and structure for Bitcoin transaction attributions.
Attributed Addresses
| Column Name | Description | Data Type | Example Values | Notes |
|---|---|---|---|---|
addr |
BTC Address | STRING | bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh | Standard Bitcoin address format. |
entity |
Blockscout Entity ID | STRING | block_xyz | Unique BlockScout Entity ID. |
beneficial_owner |
Identified or inferred beneficial owner, if known. | STRING | satoshi_nakamoto | Uniquely identifies owner within clusters. |
custodian |
Entity managing the address on behalf of others. | STRING | coinbase_custody | Custodial entity. |
tags/labels |
Labels or categories applied to the address. | STRING ARRAY | ["darknet", "centralized exchange"] | Descriptive categories. |
is_ofac_sanctioned |
Flag indicating if the address is sanctioned. | BOOLEAN | TRUE / FALSE | Sanction status. |
Attributed Transactions
| Column Name | Description | Data Type | Example Values | Notes |
|---|---|---|---|---|
txid |
Transaction ID (TXID) of the Bitcoin transaction. | STRING | 4a5e1e4baab89f3a32518a88bbd... | Transaction hash. |
timestamp |
The timestamp when the transaction was confirmed. | TIMESTAMP | 2024-02-15 14:30:00 UTC | Block confirmation time. |
is_coinjoin |
Flag indicating whether the transaction is a CoinJoin. | BOOLEAN | TRUE / FALSE | CoinJoin status. |
block |
Block number where the transaction was confirmed. | INTEGER | 783456 | Containing block. |
fee_amt |
Transaction fee in satoshis. | BIGINT | 12000 | Fee amount. |
src_addrs |
List of Bitcoin source addresses (inputs). | STRING ARRAY | ["bc1qxyz...", "1A1zP1eP5QGef..."] | Input addresses. |
src_entity |
BlockScout Entity ID for the source addresses. | STRING | block_xyz | Source entity. |
src_amt |
Total amount from source addresses in satoshis. | BIGINT | 5000000000 | Total input amount. |
dst_addr |
Bitcoin destination address (output). | STRING | 1A1zP1eP5QGefi2DMPTfTL5SLmv7... | Destination address. |
dst_entity |
BlockScout Entity ID for the destination address. | STRING | coinbase_com | Destination entity. |
dst_amt |
Amount received at the destination in satoshis. | BIGINT | 4999880000 | Total received amount. |
Entities
| Column Name | Description | Data Type | Example Values | Notes |
|---|---|---|---|---|
entity_id |
Unique BlockScout Entity ID. | STRING | coinbase_com | Unique identifier. |
name |
Proper name of the entity. | STRING | Coinbase | Entity name. |
tags |
Categorization of the entity. | STRING ARRAY | ["centralized exchange", "custodian"] | Entity category. |
Entity Financials
| Column Name | Description | Data Type | Example Values | Notes |
|---|---|---|---|---|
entity_id |
Unique BlockScout Entity ID. | STRING | coinbase_com | Unique identifier. |
addrs |
List of known Bitcoin addresses associated with the entity. | STRING ARRAY | ["bc1qxyz...", "1A1zP1eP5QGef..."] | Linked Bitcoin addresses. |
input_amt |
Total BTC received by the entity in satoshis. | BIGINT | 500000000000 | Total BTC received. |
output_amt |
Total BTC sent by the entity in satoshis. | BIGINT | 490000000000 | Total BTC sent. |
balance |
Current estimated BTC balance of the entity in satoshis. | BIGINT | 10000000000 | BTC balance. |
tx_cnt |
Total number of transactions associated with the entity. | INTEGER | 125644 | Transaction count. |
BlockScout Risk API
Supplement your compliance stack with attribution-layer intelligence focused on human exploitation signals.
Sample API Response
{
"address": "bc1qv3enmtn6jz55y2m647lf4lyvs6zw36dpkzxmyk",
"entity_name": "Boys Asylum",
"entity_id": "boys_asylum_kbv6qd",
"entity_type": "CSAM",
"entity_tags": ["darknet"],
"risk_score": 96
}Use Cases
- Pre-transaction screening
- Post-event investigations
- SAR filing enrichment
- Alert deduplication and risk overlay
Designed For
- Compliance teams at exchanges and fintechs
- Regulators and law enforcement
- NGOs and investigative journalists
Our Tools
VASP Explorer
Know your Counterparty With Confidence
Learn More
Compliance Screener
Let our Tools do the Work
Learn More
BlockScout Block Explorer
A Block Explorer but with Identity
Learn More
Data Sales
Raw Attribution Data / Alternative Data Sets
Learn More
resources
Solutions
Company
Stay Connected
info@blockscout.ai
Partners
