BLblockaid-official
Scan v1

Scan a token

Changed on

Replaces /v0/token/scan. chain moves into the body.

post/v1/token/scan

Request

Request body

assetstring required

Token identifier. A bare contract address on most chains, but carries composite identity where the chain requires it — e.g. CODE-ISSUER on Stellar, a typed string on Sui, 0.0.x on Hedera. chain stays a separate field; this string does not encode it.

chainstring required

Chain identifier. Open string rather than a closed enum, because supported chains differ per surface and expand without a major version. See the per-surface support matrix in the docs.

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
            }
          }
        ]
      }
    ]
  },
  "properties": {
    "metadata": {
      "entity_type": "token"
    }
  }
}

Changes

  • 6a9a1f3974d3Revision changes
    • 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

    • warning

      removed the request property

    • info

      added the optional property to the response with the status

  • 53277726e822Revision changes
    • 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