Surikata-X API

Interactive API reference for accessing DarkScout Intelligence data programmatically

Overview

Surikata-X provides comprehensive darknet intelligence for blockchain addresses, combining entity attribution, transaction tags, and evidence verification. This endpoint delivers real-time intelligence focused on CSAM and human trafficking cryptocurrency addresses, identifying addresses hours to days before first funding occurs.

Entity Intelligence

  • Entity Identification: Links addresses to known entities with full metadata
  • Entity Type Classification: Categorizes entities (exchange, darknet, mixer, etc.)
  • Proper Name & URLs: Provides business names and associated websites
  • Evidence Verification: Direct links to ethical screenshots proving attribution

Tag Intelligence

  • Transaction Tags: Identifies high-risk transaction patterns
  • Counterparty Analysis: Maps relationships to known nefarious entities
  • Tag Evidence: Links to screenshots verifying tag classifications
  • Network Mapping: Reveals connections within trafficking networks

Proactive Detection

  • Pre-Funding Identification: Detects addresses in CSAM and human trafficking networks before first funding
  • Real-Time Intelligence: Continuous monitoring and classification
  • Ethical Collection: All intelligence backed by filtered screenshots capturing source and address

Use Cases

Compliance & Risk Management

  • Real-Time Screening: Screen addresses during transactions for CSAM and human trafficking indicators
  • Risk Avoidance: Identify high-risk addresses before co-spending occurs
  • Due Diligence: Access complete entity profiles with evidence verification

Law Enforcement & Investigations

  • Darknet Investigations: Track cryptocurrency addresses in CSAM and human trafficking networks
  • Network Analysis: Map relationships between addresses and known entities
  • Evidence Collection: Access ethical screenshots for legal proceedings

Threat Intelligence

  • Proactive Monitoring: Identify new addresses in high-risk networks
  • Pattern Recognition: Detect transaction patterns associated with illicit activity
  • Intelligence Feeds: Integrate with threat intelligence platforms

Authentication

All requests require an API key in the x-api-key header. Obtain your API key from the dashboard at https://data-api.blockscout.ai/dashboard.

curl -X GET "https://data-api.blockscout.ai/api/v1/surikata-x?address=1PBXdHa8kgrsxjZFdiGUf5hcxr4xY8D3y1" \
  -H "x-api-key: YOUR_API_KEY_HERE"

Surikata-X Endpoint

GET /api/v1/surikata-x

Retrieve comprehensive darknet intelligence for a blockchain address, including entity attribution, transaction tags, and evidence verification.

Base URL

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

Request Parameters

Parameter
Type
Required
Description
address
string
Required
The blockchain address to query. Supports Bitcoin (P2PKH, P2SH, Bech32) and Ethereum addresses.
Examples:
  • Bitcoin P2PKH: 1BXwhiB1YoXCW6s5QcwX3ff3NUUMsSaWFo
  • Bitcoin Bech32: bc1qfxvrffsztzugcpg5msss2lhlc880g285lu0d0a
  • Ethereum: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
noCache
boolean
Optional
Set to true to bypass response caching and get fresh data. Default: false (uses 15-minute cache).

Response Structure

The API returns comprehensive intelligence data including:

Response Fields

success boolean

Indicates if the request was successful

data object

Contains the intelligence data for the queried address

address string

The queried blockchain address

chain string bitcoin | ethereum

The blockchain network detected from the address format

entity_id string | null

Unique entity identifier if the address is attributed to a known entity

entity_type string | array | null

Type(s) of entity classification (e.g., "exchange", "darknet", "mixer", "csam", "human_trafficking")

proper_name string | null

The proper business or entity name associated with the address

urls array[string]

URLs associated with the entity (websites, services, etc.)

entity_id_evidence array[string]

Direct links to evidence screenshots proving the entity attribution

tags array[TagEntry]

Transaction tags and related entity information (when address is not attributed)

tag string

The tag classification name (e.g., "csam consumer", "human_trafficking")

txid string

The transaction ID where the tag was identified

cp_addr string

The counterparty address involved in the tagged transaction

related_entity_id string | null

The entity_id of the counterparty entity

tag_evidence string | null

Direct link to evidence screenshot proving the tag classification

meta object

Response metadata

queryTime integer

Query execution time in milliseconds

timestamp string

Response timestamp in ISO 8601 format

Examples

Example: Entity Attributed Response

{
  "success": true,
  "data": {
    "address": "1BXwhiB1YoXCW6s5QcwX3ff3NUUMsSaWFo",
    "chain": "bitcoin",
    "entity_id": "example_entity_id",
    "entity_type": "exchange",
    "proper_name": "Example Exchange",
    "urls": ["https://example.com"],
    "entity_id_evidence": [
      "https://darkscoutintel.com/evidence.html?entity=example_entity_id&hash=abc12345"
    ]
  },
  "meta": {
    "queryTime": 3847,
    "timestamp": "2025-12-02T21:02:25.730Z"
  }
}

Example: Tags Only Response (Unknown Entity)

{
  "success": true,
  "data": {
    "address": "1PBXdHa8kgrsxjZFdiGUf5hcxr4xY8D3y1",
    "chain": "bitcoin",
    "entity_id": null,
    "entity_type": null,
    "proper_name": null,
    "tags": [
      {
        "tag": "csam consumer",
        "txid": "0fdcc3da34cdae427388076f8451927cd72b1d2b6e608a7e289b593eca755cdd",
        "cp_addr": "bc1qy5d4dvmp87tyhjl97chu5x0a2cwxxtgxmvrzl3",
        "related_entity_id": "counterparty_entity_id",
        "proper_name": "Counterparty Entity",
        "url": "https://counterparty.com",
        "tag_evidence": "https://darkscoutintel.com/evidence.html?entity=counterparty_entity_id&hash=def67890"
      }
    ]
  },
  "meta": {
    "queryTime": 2789,
    "timestamp": "2025-12-02T23:31:50.479Z"
  }
}

Example: No Entity or Tags Found

{
  "success": true,
  "data": {
    "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "chain": "bitcoin",
    "entity_id": null,
    "entity_type": null,
    "proper_name": null
  },
  "meta": {
    "queryTime": 1259,
    "timestamp": "2025-12-02T21:02:25.730Z"
  }
}

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

Performance

  • Response Time: Typically 3-8 seconds (median: 8s)
  • Throughput: 3.7+ requests per minute
  • Caching: Responses cached for 15 minutes
  • Timeout Protection: All operations fail-fast with aggressive timeouts

Error Handling

400
Bad Request
Missing or invalid address parameter
401
Unauthorized
Missing or invalid API key
429
Too Many Requests
Rate limit exceeded
500
Internal Server Error
Server error during processing
{
  "success": false,
  "error": "Address query parameter is required",
  "data": null
}

Try It Out

Test the Surikata-X API endpoint with your own API key and addresses.

Get your API key from the dashboard
Supports Bitcoin (P2PKH, P2SH, Bech32) and Ethereum addresses