---
title: "Get Token Map"
method: GET
path: "/v0/tokens/map/{chain}/{token_address}"
tags: ["v0"]
---

# Get Token Map

`GET /v0/tokens/map/{chain}/{token_address}`

## Path parameters

- `chain` 'eth' | 'base' | 'solana' | 'tron' | 'bsc' | 'sonic' | 'ton' | 'avalanche' | 'polygon' | 'monad' | 'hyperevm' | 'arbitrum' | 'robinhood', required
- `token_address` string, required

## Query parameters

- `limit` 80 | 250 | 500
- `timestamp` integer, nullable
- `refresh` boolean
- `use_magic_nodes` boolean
- `use_time_nodes` boolean
- `return_nodes` boolean
- `return_relationships` boolean
- `return_clusters` boolean

## Response `200`

Successful Response

- MapDataV0
  - `metadata` MapMetadataV0, required
    - `dt_update` string, required
    - `ts_update` integer, required
  - `metrics` MapMetricsV0, required
    - `supply_stats` SupplyStatsV0, required
      - `cexs` number, required
      - `dexs` number, required
      - `contracts` number, required
      - `fresh_wallets` number, required
      - `top_10_adjusted` number, required
      - `bundles` number, required
    - `scores` MapScoresV0, required
      - `bubblemaps_score` number, required
      - `gini_index` number, required
      - `herfindahl_hirschman_index` number, required
      - `nakamoto_coefficient` integer, required
  - `nodes` NodesDataV0
    - `top_holders` AccountAddressWithHolderDataWithMapContextV0[], required
      - `address` string, required
      - `address_details` AccountAddressDetails, required
        - `label` string, nullable
        - `degree` integer, required
        - `is_supernode` boolean, required
        - `is_contract` boolean, required
        - `is_cex` boolean, required
        - `is_dex` boolean, required
        - `is_paid_label` boolean
        - `entity_id` string, nullable
        - `inward_relations` integer, required
        - `outward_relations` integer, required
        - `first_activity_date` string, date-time, nullable
      - `holder_data` HolderData, required
        - `amount` number, required
        - `rank` integer, required
        - `share` number, required
      - `is_shown_on_map` boolean, required
    - `magic_nodes` AccountAddressWithDetailsWithMapContextV0[], nullable
      - `address` string, required
      - `address_details` AccountAddressDetails, required
        - `label` string, nullable
        - `degree` integer, required
        - `is_supernode` boolean, required
        - `is_contract` boolean, required
        - `is_cex` boolean, required
        - `is_dex` boolean, required
        - `is_paid_label` boolean
        - `entity_id` string, nullable
        - `inward_relations` integer, required
        - `outward_relations` integer, required
        - `first_activity_date` string, date-time, nullable
      - `is_shown_on_map` boolean, required
    - `time_nodes` TimeNodeV0[], nullable
      - `address` string, required
      - `relationships` GroupedTransferV0[], required
        - `from_address` string, required
        - `to_address` string, required
        - `rel_type` 'GROUPED_TRANSFER'
        - `data` GroupedTransferDataV0, required
          - `total_value` number, required
          - `total_transfers` integer, required
          - `first_date` integer, required
          - `last_date` integer, required
          - `token_key` TokenKey, required
            - `chain` 'eth' | 'base' | 'solana' | 'tron' | 'bsc' | 'sonic' | 'ton' | 'avalanche' | 'polygon' | 'monad' | 'hyperevm' | 'arbitrum' | 'robinhood', required
            - `address` string, required
  - `relationships` GroupedTransferV0[], nullable
    - `from_address` string, required
    - `to_address` string, required
    - `rel_type` 'GROUPED_TRANSFER'
    - `data` GroupedTransferDataV0, required
      - `total_value` number, required
      - `total_transfers` integer, required
      - `first_date` integer, required
      - `last_date` integer, required
      - `token_key` TokenKey, required
        - `chain` 'eth' | 'base' | 'solana' | 'tron' | 'bsc' | 'sonic' | 'ton' | 'avalanche' | 'polygon' | 'monad' | 'hyperevm' | 'arbitrum' | 'robinhood', required
        - `address` string, required
  - `clusters` ClusterData[], nullable
    - `share` number, required
    - `amount` number, required
    - `holder_count` integer, required
    - `holders` string[], required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/bubblemaps/apis/bubblemaps-data-api.md) · [All operations](https://skmtc.dev/bubblemaps/apis/bubblemaps-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bubblemaps/bubblemaps-data-api/revisions/38ef31a552be/schema)