Scan v1

Scan a transaction

Changed on Oct 29, 2026

Replaces the per-chain /v0/{chain}/transaction/scan routes.

A transaction is an event, not an entity. proximity on a returned category describes the cited participant — carried in signals[].evidence — not the transaction itself.

Request and response payloads are discriminated on format. v1 supports the two exchange formats; further formats are added as new members of the union.

post/v1/transaction/scan

Request

Base URL
https://api.blockaid.io
Auth
- API key in header X-API-Key
- or API key in header X-CLIENT-ID
TypeScript
https://skmtc.dev/blockaid-official/apis/blockaid-api/docs/v1/transaction/scan/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

Example request

{
  "chain": "ethereum"
}

Response

Scan completed

request_idstring required

Example response

{
  "metadata": {
    "details": {
      "chain": "ethereum"
    }
  },
  "risk": {
    "profile": {
      "id": "eup"
    },
    "negative_categories": [
      {
        "category": "rugpull",
        "signals": [
          {
            "id": "dynamic_analysis.unsellable",
            "evidence": {
              "operator_address": "0xaabbff",
              "prior_incidents": 7
            }
          }
        ]
      }
    ],
    "positive_categories": [
      {
        "category": "verified_entity",
        "signals": [
          {
            "id": "dynamic_analysis.unsellable",
            "evidence": {
              "operator_address": "0xaabbff",
              "prior_incidents": 7
            }
          }
        ]
      }
    ]
  }
}

Changes

Oct 29, 20266a9a1f3974d3 Revision changes
- breaking
  added the new required request property /
- breaking
  added the new required request property /
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property from the response with the status
- warning
  removed the request property /
- warning
  removed the request property /
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
Oct 29, 202653277726e822 Revision changes
- breaking
  added the new required request property /
- breaking
  added the new required request property /
- breaking
  added the new required request property /
- breaking
  added the new required request property /
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- breaking
  removed the required property /// from the response with the status
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the request property /
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  added the new approve enum value to the // response property for the response status
- info
  removed the allow enum value from the // response property for the response status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status

Operation history (7 revisions)