API Documentation

REST API reference for accessing DarkScout Intelligence data programmatically

DarkScout Entity Intelligence Platform

Welcome to DarkScout'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.

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 DarkScout APIs. This unique identifier is present in all transaction endpoints and can be used to retrieve the full entity profile.

Base URL

https://data-api.blockscout.ai/api/v1

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 DarkScout 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/api/v1/attributions/address/1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa" \
  -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

API Endpoints

Entity Intelligence

Search Entities with Flexible Filters

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

GET
/entities/search

Query Parameters: query, name, entity_type, country, email, cas, tag, twitter, telegram, ofac, dead, centralized, no_kyc_req

Get All Entities

Retrieve all entities from the catalogue with pagination support.

GET
/entities

Entity Metadata Lookup

Retrieve complete entity profile by entity_id.

GET
/entities/{entity_id}

Core Attribution Lookups

Address Attribution Lookup

Retrieve entity attribution for a specific blockchain address.

GET
/attributions/address/{address}

Address Transactions Lookup

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

GET
/attributions/address/{address}/transactions

Entity Addresses Lookup

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

GET
/attributions/entity/{entity_id}/addresses

Transaction Attribution Lookup

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

GET
/attributions/transaction/{txid}

Usage & Analytics

Get Current Month Usage

Retrieve total API usage for the current billing month.

GET
/usage

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

Ready to Get Started?

Request API access and start integrating DarkScout Intelligence into your platform.

Request API Access