---
title: "Get Map Data"
method: GET
path: "/maps/{chain}/{token_address}"
tags: ["Maps"]
deprecated: true
---

# Get Map Data

`GET /maps/{chain}/{token_address}`

> **Deprecated.**

Deprecated: use `GET /v0/tokens/map/{chain}/{token_address}` instead. This endpoint will be removed in the future.

## Path parameters

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

## Query parameters

- `use_magic_nodes` boolean
- `return_nodes` boolean
- `return_relationships` boolean
- `return_clusters` boolean
- `return_decentralization_score` boolean

## Response `200`

Successful Response

- MapData
  - `metadata` MapMetadata, required
    - `dt_update` string, required
    - `ts_update` integer, required
    - `identified_supply` IdentifiedSupply, required
      - `share_in_cexs` number, required
      - `share_in_dexs` number, required
      - `share_in_other_contracts` number, required
  - `nodes` NodesData
    - `top_holders` AccountAddressWithHolderDataWithMapContext[], 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` AccountAddressWithDetailsWithMapContext[], 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
  - `relationships` GroupedTransfer[], nullable
    - `from_address` string, required
    - `to_address` string, required
    - `rel_type` 'GROUPED_TRANSFER'
    - `data` GroupedTransferData, required
      - `total_value` number, required
      - `total_transfers` integer, required
      - `first_date` integer, required
      - `last_date` integer, required
      - `token_ref` union, required
        - ContractTokenRef
          - `chain` 'eth' | 'base' | 'solana' | 'tron' | 'bsc' | 'apechain' | 'ton' | 'polygon' | 'avalanche' | 'sonic' | 'hyperevm' | 'monad' | 'aptos' | 'arbitrum' | 'robinhood', required
          - `address` string, required
        - NativeTokenRef
          - `id` 'ETH' | 'ETH_BASE' | 'SOL' | 'TRX' | 'BNB' | 'APE' | 'TON' | 'POL' | 'AVAX' | 'S' | 'HYPE' | 'MONAD' | 'ETH_ARB' | 'APT' | 'ETH_ROBINHOOD', required
  - `decentralization_score` number, nullable
  - `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)