Skip to main content
GET
/
v0
/
token
/
snapshot
/
diff
Diff Snapshot
curl --request GET \
  --url https://api.blockaid.io/v0/token/snapshot/diff \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "result_type": "Benign",
      "malicious_score": "<string>",
      "attack_types": {},
      "chain": "arbitrum",
      "address": "<string>",
      "metadata": {
        "type": "<string>",
        "name": "<string>",
        "symbol": "<string>",
        "decimals": 123,
        "image_url": "<string>",
        "description": "<string>",
        "deployer": "<string>",
        "deployer_balance": {
          "amount": 123,
          "amount_wei": "<string>"
        },
        "contract_balance": {
          "amount": 123,
          "amount_wei": "<string>"
        },
        "owner_balance": {
          "amount": 123,
          "amount_wei": "<string>"
        },
        "owner": "<string>",
        "creation_timestamp": "<string>",
        "external_links": {
          "homepage": "<string>",
          "twitter_page": "<string>",
          "telegram_channel_id": "<string>"
        },
        "urls": [
          "<string>"
        ],
        "malicious_urls": [
          "<string>"
        ],
        "token_creation_initiator": "<string>",
        "mint_authority": "<string>",
        "update_authority": "<string>",
        "freeze_authority": "<string>"
      },
      "fees": {
        "transfer": 123,
        "transfer_fee_max_amount": 123,
        "buy": 123,
        "sell": 123
      },
      "features": [],
      "trading_limits": {
        "max_buy": {
          "amount": 123,
          "amount_wei": "<string>"
        },
        "max_sell": {
          "amount": 123,
          "amount_wei": "<string>"
        },
        "max_holding": {
          "amount": 123,
          "amount_wei": "<string>"
        },
        "sell_limit_per_block": {
          "amount": 123,
          "amount_wei": "<string>"
        }
      },
      "financial_stats": {
        "supply": 123,
        "holders_count": 123,
        "usd_price_per_unit": 123,
        "burned_liquidity_percentage": 123,
        "locked_liquidity_percentage": 123,
        "top_holders": [],
        "total_reserve_in_usd": 123
      }
    }
  ],
  "current_page": "<string>",
  "previous_page": "<string>",
  "next_page": "<string>"
}

Authorizations

X-API-Key
string
header
required

Query Parameters

chain
enum<string>
required

The chain name

Available options:
arbitrum,
avalanche,
base,
bsc,
ethereum,
optimism,
polygon,
zora,
solana,
starknet,
starknet-sepolia,
stellar,
linea,
degen,
zksync,
scroll,
blast,
soneium-minato,
base-sepolia,
bitcoin,
abstract,
soneium,
ink,
zero-network,
berachain,
unichain,
ronin,
sui,
hedera
timeframe
integer
default:10

Timeframe in minutes

Required range: 0 < x <= 360
cursor
string | null

Cursor to start from, if not provided, the first page will be returned

size
integer
default:50

Number of tokens to return in a page

Required range: 0 < x <= 5000

Response

Successful Response

items
TokenValidationResponse · object[]
required
current_page
string
required

Cursor to refetch the current page

previous_page
string | null

Cursor for the previous page

next_page
string | null

Cursor for the next page