API docs by Redocly

Blockscout Data API (1.0.0)

Download OpenAPI specification:

API Support: bryan@blockscout.ai License: Proprietary

Blockscout Entity Intelligence Platform

Introduction

Welcome to Blockscout's Entity Intelligence API - the comprehensive blockchain attribution platform serving law enforcement, financial institutions, and compliance teams worldwide. Our platform provides real-time access to a curated catalogue of 30,000+ entities spanning legitimate businesses and illicit operations across the Bitcoin blockchain.

Core Capabilities

Entity Attribution

Every blockchain address and transaction in our system maps to real-world entities through our proprietary attribution engine. Using advanced clustering algorithms and human intelligence gathering, we maintain the industry's most comprehensive entity database.

The Entity Catalogue

Our database contains 30,000+ meticulously researched entities including:

  • Legitimate Businesses: Centralized exchanges, DeFi protocols, payment processors, mining pools
  • Illicit Operations: Darknet markets, ransomware groups, fraud schemes, sanctioned entities
  • High-Risk Services: Mixers, gambling sites, unregistered money services
  • Specialized Categories: Chemical vendors, weapons dealers, human trafficking networks

Primary Key Architecture

The entity_id field serves as the universal primary key across all Blockscout APIs. This unique identifier:

  • Is present in all transaction endpoints
  • Can be used to retrieve the full entity profile

Use Cases

Compliance & KYC/AML

  • Automated Screening: Build real-time screening against 30,000+ entities
  • Sanctions Checking: Identify OFAC and internationally sanctioned entities
  • Enhanced Due Diligence: Access complete entity profiles with business information

Law Enforcement & Investigations

  • Attribution Analysis: Link cryptocurrency addresses to real-world entities
  • Network Mapping: Trace relationships between entities through transaction flows
  • Darknet Investigations: Track marketplace vendors and illegal service providers
  • Asset Recovery: Identify exchange accounts for freezing orders

Financial Intelligence

  • Threat Intelligence: Monitor emerging threats and new entity classifications
  • Pattern Recognition: Identify transaction patterns across entity types
  • Regulatory Reporting: Generate compliance reports with full entity attribution
  • Risk Management: Assess counterparty risk using comprehensive entity data

Data Quality & Coverage

Global Intelligence Network

Our attribution data is powered by:

  • Human Intelligence: Global network of researchers and analysts
  • Technical Analysis: State-of-the-art blockchain clustering algorithms
  • Open Source Intelligence: Continuous monitoring of public sources
  • Partner Data: Collaboration with law enforcement and financial institutions

Real-Time Updates

  • New entities added daily as they emerge
  • Continuous enrichment of existing entity profiles
  • Immediate flagging of newly sanctioned entities

Authentication

All API endpoints require authentication using an API key. Include your API key in the request headers:

x-api-key: YOUR_API_KEY_HERE

Getting an API Key

  1. Access the dashboard at https://data-api.blockscout.ai/dashboard
  2. Sign in using Single Sign-On (SSO) with your Blockscout account
  3. Navigate to the "API Keys" section
  4. Create and manage your API keys

Example Request

curl -X GET "https://data-api.blockscout.ai/v1/attributions/darknet/addresses" \
  -H "x-api-key: YOUR_API_KEY_HERE"

Rate Limiting

Rate limits are enforced based on your subscription tier. Every response includes rate limit headers:

  • X-RateLimit-Limit: Maximum requests allowed
  • X-RateLimit-Remaining: Requests remaining
  • X-RateLimit-Reset: When the rate limit resets

Error Responses

  • 401 Unauthorized: Missing or invalid API key
  • 403 Forbidden: Insufficient permissions for the requested resource
  • 429 Too Many Requests: Rate limit exceeded

Entity Documentation

Comprehensive documentation of entity data model, fields, and examples

Entity Intelligence

API endpoints for searching and retrieving entities from the catalogue

Search Entities with Flexible Filters

Search and filter entities using flexible, multi-field queries with in-memory indexing for optimal performance.

Use Cases:

  • Compliance filtering: Find all non-OFAC entities in specific countries
  • Entity discovery: Full-text search across names and descriptions
  • Chemical tracking: Search by CAS numbers for precursor chemical vendors
  • Contact lookup: Find entities by email, Twitter, or Telegram
  • Risk filtering: Filter by entity type, tags, and regulatory status
  • Multi-criteria research: Combine multiple filters for precise targeting

Search Strategy:

  • AND Logic: All specified filters must match (narrow results)
  • Array Fields: Search across all positions (countries, CAS, tags use OR within array)
  • Text Search: Uses fuzzy matching via Fuse.js for typo tolerance
  • Performance: In-memory search index provides <50ms response times

Available Filters:

  • query: Full-text search across entity name and description (fuzzy)
  • name: Filter by entity name (case-insensitive partial match)
  • entity_type: Filter by entity type (case-insensitive partial match)
  • country: Search all 6 associated country fields
  • email: Filter by contact email
  • cas: Search all 16 CAS number fields
  • tag: Search all 7 entity tag fields
  • twitter: Filter by Twitter handle
  • telegram: Filter by Telegram handle
  • ofac: Filter by OFAC sanctioned status (boolean)
  • dead: Filter by defunct/inactive status (boolean)
  • centralized: Filter by centralization status (boolean)
  • no_kyc_req: Filter by KYC requirement status (boolean)

Example Queries:

  • ?country=China&cas=124-38-9 - Chinese entities with specific CAS number
  • ?query=exchange&ofac=false&dead=false - Active, non-sanctioned exchanges
  • ?entity_type=darknet&country=Russia - Russian darknet entities
  • ?email=support@ - Entities with support email addresses
Authorizations:
ApiKeyAuth
query Parameters
query
string
Example: query=bitcoin exchange

Full-text search across entity name and description (fuzzy matching)

name
string
Example: name=coinbase

Filter by entity name (case-insensitive partial match)

entity_type
string
Example: entity_type=centralized exchange

Filter by entity type (case-insensitive partial match)

country
string
Example: country=United States

Search across all associated country fields (partial match)

email
string
Example: email=support@

Filter by contact email (partial match)

cas
string
Example: cas=124-38-9

Search across all CAS (Chemical Abstract Service) number fields

tag
string
Example: tag=custodian

Search across all entity tag fields (partial match)

twitter
string
Example: twitter=@coinbase

Filter by Twitter handle (partial match)

telegram
string
Example: telegram=@support

Filter by Telegram handle (partial match)

ofac
boolean

Filter by OFAC sanctioned status

dead
boolean

Filter by defunct/inactive status

centralized
boolean
Example: centralized=true

Filter by centralization status

no_kyc_req
boolean

Filter by KYC requirement status

limit
integer [ 1 .. 1000 ]
Default: 100

Number of results per page

offset
integer >= 0
Default: 0

Pagination offset

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Get All Entities

Retrieve all entities from the Entity Intelligence catalogue with pagination.

Use Cases:

  • Browse the complete entity database
  • Export entity data for compliance systems
  • Build local entity reference databases
  • Bulk entity profiling and analysis

Endpoint Features:

  • Returns all entities sorted deterministically by internal ID
  • Pagination support for efficient data retrieval
  • Complete entity metadata for each entry

Returns:

  • Array of all entity objects
  • Total count for pagination
  • Query execution time metrics
Authorizations:
ApiKeyAuth
query Parameters
limit
integer [ 1 .. 1000 ]
Default: 100

Number of results per page

offset
integer >= 0
Default: 0

Pagination offset

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Entity Metadata Lookup

Retrieve comprehensive metadata for a specific entity from the Entity Intelligence database.

Use Cases:

  • Entity due diligence
  • Risk assessment and profiling
  • Compliance research
  • Regulatory reporting

Response includes:

  • Complete entity profile
  • Business information (CEO, year founded, contact details)
  • Regulatory status (OFAC, KYC requirements)
  • Geographic information (associated countries)
  • Social media and communication channels
  • Parent entity relationships
  • Chemical tracking data (for precursor chemical vendors)

Note: This endpoint returns the full entity object. Not all fields will be populated for every entity, especially illicit entities which lack business information.

Authorizations:
ApiKeyAuth
path Parameters
entity_id
required
string
Example: coinbase

Unique entity identifier

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Core Attribution Lookups

Real-time attribution lookups for addresses, transactions, and entities

Address Attribution Lookup

Retrieve attribution data for a specific blockchain address in real-time.

Use Cases:

  • Real-time compliance checks during transactions
  • Address screening for withdrawals
  • KYC/AML verification
  • Risk assessment for incoming payments

Response includes:

  • Entity identification
  • Entity type classification
  • Classification tags
  • Beneficial owner information
  • Custodian details

Supported Address Formats:

  • Bitcoin P2PKH (1...)
  • Bitcoin P2SH (3...)
  • Bitcoin Bech32 (bc1...)
Authorizations:
ApiKeyAuth
path Parameters
address
required
string
Example: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa

Blockchain address to lookup

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Address Transactions Lookup

Retrieve all transactions for a specific blockchain address with high-performance cursor-based pagination.

Use Cases:

  • Transaction history analysis for compliance
  • Address activity monitoring
  • Flow tracking and forensics
  • Customer due diligence and transaction review

Pagination Methods:

Cursor-Based (Recommended):

  • Use the after parameter with the next_cursor from previous response
  • Constant performance regardless of page depth
  • Ideal for addresses with millions of transactions
  • ~1-2 seconds per page at any depth

Offset-Based (Legacy):

  • Use offset and limit parameters
  • Backwards compatible with existing integrations
  • Performance degrades on deep pages
  • Use for addresses with few transactions or when you need total count

Query Details:

  • Finds transactions where address appears in inputs OR outputs
  • Results sorted by block number ASC (deterministic ordering)
  • Each result includes: txid, timestamp, block number, block date

Response includes:

  • Array of transaction metadata
  • Pagination cursor for next page
  • Optional total count (offset mode only)
Authorizations:
ApiKeyAuth
path Parameters
address
required
string
Example: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa

Blockchain address to query

query Parameters
limit
integer [ 1 .. 1000 ]
Default: 100

Number of results per page

after
string
Example: after=507f1f77bcf86cd799439011

Cursor for pagination (use next_cursor from previous response). Omit this parameter for the first page. When using cursor pagination, offset is ignored.

offset
integer >= 0
Default: 0

Pagination offset (legacy method). Only used when after parameter is not provided. Note: Performance degrades on deep pages.

Responses

Response samples

Content type
application/json
Example
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Entity Addresses Lookup

Retrieve all blockchain addresses associated with a specific entity with high-performance cursor-based pagination.

Use Cases:

  • Entity footprint investigation
  • Comprehensive address mapping for compliance
  • Risk exposure analysis across all entity addresses
  • Network analysis and flow tracking

Pagination Methods:

Cursor-Based (Recommended):

  • Use the after parameter with the next_cursor from previous response
  • Constant performance regardless of page depth
  • Ideal for large entities (100K+ addresses)
  • ~1 second per page at any depth

Offset-Based (Legacy):

  • Use offset and limit parameters
  • Backwards compatible with existing integrations
  • Performance degrades on deep pages (page 100+ may be slow)
  • Use for small entities or when you need total count

Performance Comparison:

  • Page 1: Both methods ~1s
  • Page 100 (offset=10,000): Cursor ~2s vs Offset ~25s
  • Page 1000 (offset=100,000): Cursor ~1s vs Offset ~85s

Response includes:

  • Entity metadata (name, type)
  • Array of blockchain addresses
  • Pagination cursor for next page
  • Optional total count (offset mode only)
Authorizations:
ApiKeyAuth
path Parameters
entity_id
required
string
Example: cryptomus

Unique entity identifier

query Parameters
limit
integer [ 1 .. 1000 ]
Default: 100

Number of results per page

after
string
Example: after=68f63533b088cee5b613f47e

Cursor for pagination (use next_cursor from previous response). Omit this parameter for the first page. When using cursor pagination, offset is ignored.

offset
integer >= 0
Default: 0

Pagination offset (legacy method). Only used when after parameter is not provided. Note: Performance degrades on deep pages.

include_metadata
boolean
Default: true

Include entity metadata (name, type) in response. Set to false for slightly faster queries (~200ms improvement).

Responses

Response samples

Content type
application/json
Example
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Transaction Attribution Lookup

Retrieve transaction data enriched with entity attributions for all inputs and outputs.

Use Cases:

  • Transaction monitoring and compliance
  • Flow analysis between entities
  • Identifying counterparties in transactions
  • Risk assessment for transaction approvals

Response includes:

  • Complete transaction details (block, timestamp, fees)
  • All inputs with entity attributions
  • All outputs with entity attributions
  • OFAC sanctions status for each entity
  • Risk tags and classifications
Authorizations:
ApiKeyAuth
path Parameters
txid
required
string^[a-fA-F0-9]{64}$
Example: 0e3e2357e806b6cdb1f70b54c3a3a17b6714ee1f0e68bebb44a74b1efd512098

Transaction ID (64-character hex string)

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Illicit Activities / Drugs

Drugs - Narcotics Distribution Networks

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Pagination cursor (24-character hexadecimal MongoDB ObjectId)

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Drugs - Transaction History

Retrieve complete Bitcoin transaction history for addresses associated with narcotics distribution networks. Returns enriched transaction data with entity attribution and geographic intelligence.

Transactions are returned using address-by-address pagination for optimal performance. The service processes one address at a time, returning up to 50 transactions per request.

See the attributions endpoint description for detailed use cases and technical capabilities.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
Example: start_date=2024-01-01

Start date for transaction history (YYYY-MM-DD)

end_date
required
string <date>
Example: end_date=2024-12-31

End date for transaction history (YYYY-MM-DD)

direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"

Transaction direction filter

cursor
string

Pagination cursor (format "addressId_blockNum_txid")

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Illicit Activities / CSAM

CSAM - Child Exploitation Financial Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Pagination cursor (24-character hexadecimal MongoDB ObjectId)

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

CSAM - Transaction History

Law Enforcement Use Only: Retrieve complete Bitcoin transaction history for addresses associated with CSAM distribution and consumption networks. Returns enriched transaction data with entity attribution and evidentiary documentation.

Transactions are returned using address-by-address pagination for optimal performance. The service processes one address at a time, returning up to 50 transactions per request.

See the attributions endpoint description for detailed use cases and technical capabilities.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
Example: start_date=2024-01-01

Start date for transaction history (YYYY-MM-DD)

end_date
required
string <date>
Example: end_date=2024-12-31

End date for transaction history (YYYY-MM-DD)

direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"

Transaction direction filter

cursor
string

Pagination cursor (format "addressId_blockNum_txid")

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Illicit Activities / Weapons & Violence

Weapons & Violence - Illicit Arms Trade Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Pagination cursor (24-character hexadecimal MongoDB ObjectId)

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Weapons & Violence - Transaction History

Retrieve complete Bitcoin transaction history for addresses associated with illicit arms trafficking and weapons commerce networks. Returns enriched transaction data with entity attribution and geographic intelligence.

Transactions are returned using address-by-address pagination for optimal performance. The service processes one address at a time, returning up to 50 transactions per request.

See the attributions endpoint description for detailed use cases and technical capabilities.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
Example: start_date=2024-01-01

Start date for transaction history (YYYY-MM-DD)

end_date
required
string <date>
Example: end_date=2024-12-31

End date for transaction history (YYYY-MM-DD)

direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"

Transaction direction filter

cursor
string

Pagination cursor (format "addressId_blockNum_txid")

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Illicit Activities / Human Trafficking

Human Trafficking - Global Exploitation Network Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Pagination cursor (24-character hexadecimal MongoDB ObjectId)

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Human Trafficking - Transaction History

Retrieve complete Bitcoin transaction history for addresses associated with human trafficking and exploitation networks. Returns enriched transaction data with entity attribution and trafficking corridor intelligence.

Transactions are returned using address-by-address pagination for optimal performance. The service processes one address at a time, returning up to 50 transactions per request.

See the attributions endpoint description for detailed use cases and technical capabilities.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
Example: start_date=2024-01-01

Start date for transaction history (YYYY-MM-DD)

end_date
required
string <date>
Example: end_date=2024-12-31

End date for transaction history (YYYY-MM-DD)

direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"

Transaction direction filter

cursor
string

Pagination cursor (format "addressId_blockNum_txid")

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Cybercrime & Dark Web / Darknet

Darknet - Global Underground Marketplace Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Pagination cursor (24-character hexadecimal MongoDB ObjectId)

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Darknet - Transaction History

Retrieve complete Bitcoin transaction history for addresses associated with darknet marketplace operations and related services. Returns enriched transaction data with entity attribution and marketplace association intelligence.

Transactions are returned using address-by-address pagination for optimal performance. The service processes one address at a time, returning up to 50 transactions per request.

See the attributions endpoint description for detailed use cases and technical capabilities.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
Example: start_date=2024-01-01

Start date for transaction history (YYYY-MM-DD)

end_date
required
string <date>
Example: end_date=2024-12-31

End date for transaction history (YYYY-MM-DD)

direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"

Transaction direction filter

cursor
string

Pagination cursor (format "addressId_blockNum_txid")

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Cybercrime & Dark Web / Hacking & Cybercrime

Hacking & Cybercrime - Global Threat Actor Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Pagination cursor (24-character hexadecimal MongoDB ObjectId)

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Hacking & Cybercrime - Transaction History

Retrieve complete Bitcoin transaction history for addresses associated with cybercrime operations and threat actor networks. Returns enriched transaction data with entity attribution and threat actor categorization.

Transactions are returned using address-by-address pagination for optimal performance. The service processes one address at a time, returning up to 50 transactions per request.

See the attributions endpoint description for detailed use cases and technical capabilities.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
Example: start_date=2024-01-01

Start date for transaction history (YYYY-MM-DD)

end_date
required
string <date>
Example: end_date=2024-12-31

End date for transaction history (YYYY-MM-DD)

direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"

Transaction direction filter

cursor
string

Pagination cursor (format "addressId_blockNum_txid")

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Cybercrime & Dark Web / Regional Cybercrime Hubs

Regional Cybercrime Hubs - Geographic Threat Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Regional Cybercrime Hubs - Transaction History

Retrieve transaction history for addresses in regional cybercrime hub jurisdictions.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
end_date
required
string <date>
direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"
cursor
string

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Cybercrime & Dark Web / Darknet Onion Conduits

Darknet Onion Conduits - Underground Infrastructure Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Darknet Onion Conduits - Transaction History

Retrieve transaction history for darknet infrastructure in operational hub jurisdictions.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
end_date
required
string <date>
direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"
cursor
string

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Financial Crime & Sanctions / Illicit Funding

Illicit Funding - Terrorism & Money Laundering Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Pagination cursor (24-character hexadecimal MongoDB ObjectId)

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Illicit Funding - Transaction History

Retrieve complete Bitcoin transaction history for addresses associated with terrorism financing, money laundering operations, and sanctions evasion networks. Returns enriched transaction data with entity attribution and financial intelligence indicators.

Transactions are returned using address-by-address pagination for optimal performance. The service processes one address at a time, returning up to 50 transactions per request.

See the attributions endpoint description for detailed use cases and technical capabilities.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
Example: start_date=2024-01-01

Start date for transaction history (YYYY-MM-DD)

end_date
required
string <date>
Example: end_date=2024-12-31

End date for transaction history (YYYY-MM-DD)

direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"

Transaction direction filter

cursor
string

Pagination cursor (format "addressId_blockNum_txid")

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Financial Crime & Sanctions / Sanctions & SDN Hotspots

Sanctions & SDN Hotspots - Sanctions Evasion Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Pagination cursor (24-character hexadecimal MongoDB ObjectId)

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Sanctions & SDN Hotspots - Transaction History

Retrieve complete Bitcoin transaction history for addresses associated with OFAC-sanctioned jurisdictions and SDN entities. Returns enriched transaction data with entity attribution and sanctions compliance indicators.

Transactions are returned using address-by-address pagination for optimal performance. The service processes one address at a time, returning up to 50 transactions per request.

See the attributions endpoint description for detailed use cases and technical capabilities.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
Example: start_date=2024-01-01

Start date for transaction history (YYYY-MM-DD)

end_date
required
string <date>
Example: end_date=2024-12-31

End date for transaction history (YYYY-MM-DD)

direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"

Transaction direction filter

cursor
string

Pagination cursor (format "addressId_blockNum_txid")

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Financial Crime & Sanctions / Offshore & Tax Havens

Offshore & Tax Havens - Financial Secrecy Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Offshore & Tax Havens - Transaction History

Retrieve transaction history for addresses in offshore and tax haven jurisdictions.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
end_date
required
string <date>
direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"
cursor
string

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Financial Crime & Sanctions / Cross-Border Payments

Cross-Border Payments - International Remittance Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Cross-Border Payments - Transaction History

Retrieve transaction history for cross-border payment and remittance addresses.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
end_date
required
string <date>
direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"
cursor
string

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Financial Crime & Sanctions / Shell Company Routes

Shell Company Routes - Trade-Based Money Laundering Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Shell Company Routes - Transaction History

Retrieve transaction history for addresses linked to shell companies and trade manipulation.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
end_date
required
string <date>
direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"
cursor
string

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Regional Intelligence / BRICS Emerging Bloc

BRICS Emerging Bloc - Geopolitical Financial Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Pagination cursor (24-character hexadecimal MongoDB ObjectId)

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

BRICS Emerging Bloc - Transaction History

Retrieve complete Bitcoin transaction history for addresses associated with BRICS nations and emerging partner countries. Returns enriched transaction data with entity attribution and geopolitical intelligence indicators.

Transactions are returned using address-by-address pagination for optimal performance. The service processes one address at a time, returning up to 50 transactions per request.

See the attributions endpoint description for detailed use cases and technical capabilities.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
Example: start_date=2024-01-01

Start date for transaction history (YYYY-MM-DD)

end_date
required
string <date>
Example: end_date=2024-12-31

End date for transaction history (YYYY-MM-DD)

direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"

Transaction direction filter

cursor
string

Pagination cursor (format "addressId_blockNum_txid")

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Regional Intelligence / Golden Triangle

Golden Triangle - Southeast Asia Narcotics Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Pagination cursor (24-character hexadecimal MongoDB ObjectId)

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Golden Triangle - Transaction History

Retrieve complete Bitcoin transaction history for addresses associated with Golden Triangle narcotics trafficking operations. Returns enriched transaction data with entity attribution and regional trafficking intelligence.

Transactions are returned using address-by-address pagination for optimal performance. The service processes one address at a time, returning up to 50 transactions per request.

See the attributions endpoint description for detailed use cases and technical capabilities.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
Example: start_date=2024-01-01

Start date for transaction history (YYYY-MM-DD)

end_date
required
string <date>
Example: end_date=2024-12-31

End date for transaction history (YYYY-MM-DD)

direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"

Transaction direction filter

cursor
string

Pagination cursor (format "addressId_blockNum_txid")

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Regional Intelligence / Golden Crescent

Golden Crescent - Opium Production Region Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Pagination cursor (24-character hexadecimal MongoDB ObjectId)

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Golden Crescent - Transaction History

Retrieve complete Bitcoin transaction history for addresses associated with Golden Crescent narcotics trafficking operations. Returns enriched transaction data with entity attribution and regional trafficking intelligence.

Transactions are returned using address-by-address pagination for optimal performance. The service processes one address at a time, returning up to 50 transactions per request.

See the attributions endpoint description for detailed use cases and technical capabilities.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
Example: start_date=2024-01-01

Start date for transaction history (YYYY-MM-DD)

end_date
required
string <date>
Example: end_date=2024-12-31

End date for transaction history (YYYY-MM-DD)

direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"

Transaction direction filter

cursor
string

Pagination cursor (format "addressId_blockNum_txid")

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Regional Intelligence / Kleptocracy & Elite Capture

Kleptocracy & Elite Capture - Authoritarian Finance Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Pagination cursor

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Kleptocracy & Elite Capture - Transaction History

Retrieve Bitcoin transaction history for addresses associated with kleptocratic regimes and elite capture networks.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>

Start date (YYYY-MM-DD)

end_date
required
string <date>

End date (YYYY-MM-DD)

direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"
cursor
string

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Regional Intelligence / Maritime Chokepoints

Maritime Chokepoints - Strategic Trade Route Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Maritime Chokepoints - Transaction History

Retrieve transaction history for addresses in strategic maritime jurisdictions.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
end_date
required
string <date>
direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"
cursor
string

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Regional Intelligence / LATAM Region

LATAM Region - Latin American Cryptocurrency Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

LATAM Region - Transaction History

Retrieve transaction history for addresses in Latin American region.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
end_date
required
string <date>
direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"
cursor
string

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Energy & Resources / Energy & Oil Transit

Energy & Oil Transit - Petro-State Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Energy & Oil Transit - Transaction History

Retrieve transaction history for addresses in energy-producing and oil transit countries.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
end_date
required
string <date>
direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"
cursor
string

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Energy & Resources / Critical Minerals

Critical Minerals - Strategic Resource Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Critical Minerals - Transaction History

Retrieve transaction history for addresses in critical mineral supply chain regions.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
end_date
required
string <date>
direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"
cursor
string

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Trafficking & Arms / Trafficking Corridors

Trafficking Corridors - Human Smuggling Route Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Trafficking Corridors - Transaction History

Retrieve transaction history for addresses along human trafficking and smuggling corridors.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
end_date
required
string <date>
direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"
cursor
string

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Intelligence / Trafficking & Arms / Arms Trafficking Routes

Arms Trafficking Routes - Weapons Proliferation Intelligence

Retrieve attribution records for this category. See tag description for detailed overview, technical capabilities, and use cases.

Authorizations:
ApiKeyAuth
query Parameters
cursor
string^[0-9a-f]{24}$

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": [
    ],
  • "meta": {
    }
}

Arms Trafficking Routes - Transaction History

Retrieve transaction history for addresses along arms trafficking and sanctions evasion routes.

Authorizations:
ApiKeyAuth
query Parameters
start_date
required
string <date>
end_date
required
string <date>
direction
string
Default: "both"
Enum: "incoming" "outgoing" "both"
cursor
string

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    },
  • "meta": {
    }
}

Usage & Analytics

Monitor API usage statistics and performance metrics

Get current month usage

Retrieve total API usage for the current billing month.

Authorizations:
ApiKeyAuth

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "data": {
    }
}

Admin

API key management and administration