---
title: "GET /v2/market/tokens/{chain_id}/{address}"
method: GET
path: "/v2/market/tokens/{chain_id}/{address}"
tags: ["Product Market"]
---

# GET /v2/market/tokens/{chain_id}/{address}

`GET /v2/market/tokens/{chain_id}/{address}`

## Request

- Base URL: `https://api.arbital.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.arbital.xyz/v2/market/tokens/{chain_id}/{address}`
- Auth: none declared

Returns bounded provider-normalized metadata and market detail plus nullable informational Birdeye security signals for one canonical asset. Arc detail is Mobula-backed and intentionally receives no Birdeye security enrichment. Token detail remains available when security enrichment is unavailable.

## Path parameters

- `chain_id` 'solana:mainnet-beta' | 'eip155:1' | 'eip155:56' | 'eip155:143' | 'eip155:4663' | 'eip155:5042' | 'eip155:8453' | 'eip155:42161', required
- `address` string, required

## Response `200`

Current token metadata, market detail, and optional security enrichment

- ProductTokenDetailResponseV1
  - `token` ProductTokenDetailV1, required
    - `asset` union, required
      - object
        - `address` string, required
        - `chain_id` 'solana:mainnet-beta', required
      - object
        - `address` string, required
        - `chain_id` 'eip155:1' | 'eip155:56' | 'eip155:143' | 'eip155:4663' | 'eip155:5042' | 'eip155:8453' | 'eip155:42161', required
    - `evidence` ProductTokenDetailEvidenceV1: Optional field-group evidence. Legacy observed_at_ms retains its existing conditional meaning: preferred price clock when selected, otherwise Mobula base receipt. Only the group clocks describe the age of the fields they cover. No inference of full-detail or security completeness is permitted.
      - `scope` 'token_detail', required
      - `served_at_ms` string, required
      - `groups` ProductTokenFactGroupEvidenceV1[], required
        - `scope` 'base' | 'metadata' | 'price' | 'deployer_funding', required
        - `source` 'mobula' | 'codex' | 'arbital_catalogue' | 'preferred_metadata' | 'configured_price', required
        - `method` 'token_details' | 'token_search' | 'catalogue' | 'preferred_metadata' | 'configured_price' | 'wallet_labels' | 'filtered_minute_bar_close' | 'filtered_second_bar_close', required
        - `provider_observed_at_ms` string, nullable, required
        - `retrieved_at_ms` string, nullable, required
        - `valid_until_ms` string, nullable, required
        - `freshness` 'fresh' | 'stale' | 'unknown', required
        - `availability` 'available' | 'partial' | 'unavailable' | 'not_applicable', required
        - `coverage` object, required
          - `exhaustive` false, required
          - `fields` ProductTokenEvidenceFieldV1[], required
          - `missing_fields` ProductTokenEvidenceFieldV1[], required
    - `ath_price_usd` string, nullable, required
    - `atl_price_usd` string, nullable, required
    - `bundlers_holdings_pct` string, nullable, required
    - `buy_tax_pct` string, nullable, required
    - `circulating_supply` string, nullable, required
    - `created_at` string, nullable, required
    - `decimals` integer, nullable, required
    - `deployer` union, required
      - object
        - `address` string, required
        - `chain_id` 'solana:mainnet-beta', required
      - object
        - `address` string, required
        - `chain_id` 'eip155:1' | 'eip155:56' | 'eip155:143' | 'eip155:4663' | 'eip155:5042' | 'eip155:8453' | 'eip155:42161', required
    - `deployer_funding` ProductTokenDeployerFundingV1, required
      - `amount` string, nullable, required
      - `currency_name` string, nullable, required
      - `currency_symbol` string, nullable, required
      - `funded_at` string, nullable, required
      - `source` union, required
        - object
          - `address` string, required
          - `chain_id` 'solana:mainnet-beta', required
        - object
          - `address` string, required
          - `chain_id` 'eip155:1' | 'eip155:56' | 'eip155:143' | 'eip155:4663' | 'eip155:5042' | 'eip155:8453' | 'eip155:42161', required
      - `source_logo_url` string, uri, nullable, required
      - `source_name` string, nullable, required
      - `transaction_hash` string, nullable, required
    - `description` string, nullable, required
    - `developer_holdings_pct` string, nullable, required
    - `dexscreener_ad_paid` boolean, nullable, required
    - `dexscreener_boosted` boolean, nullable, required
    - `dexscreener_enhanced` boolean, nullable, required
    - `dexscreener_social_paid` boolean, nullable, required
    - `fully_diluted_market_cap_usd` string, nullable, required
    - `holders_count` string, nullable, required
    - `honeypot` boolean, nullable, required
    - `image_url` string, uri, nullable, required
    - `insiders_holdings_pct` string, nullable, required
    - `is_scam` boolean, nullable, required
    - `liquidity_burned_pct` string, nullable, required
    - `liquidity_usd` string, nullable, required
    - `market_cap_usd` string, nullable, required
    - `name` string, nullable, required
    - `observed_at_ms` string, required
    - `price_change_1h_pct` string, nullable, required
    - `price_change_24h_pct` string, nullable, required
    - `price_change_4h_pct` string, nullable, required
    - `price_change_5m_pct` string, nullable, required
    - `price_usd` string, nullable, required
    - `pro_traders_count` string, nullable, required
    - `rug_pull` boolean, nullable, required
    - `sell_tax_pct` string, nullable, required
    - `snipers_holdings_pct` string, nullable, required
    - `socials` ProductTokenSocialsV1, required
      - `telegram` string, uri, nullable, required
      - `twitter` string, uri, nullable, required
      - `website` string, uri, nullable, required
    - `symbol` string, nullable, required
    - `top_10_holdings_pct` string, nullable, required
    - `total_supply` string, nullable, required
    - `trade_flow` ProductTokenTradeFlowV1, required
      - `1h` ProductTokenTradeFlowWindowV1, required: Mobula-provided, token-relative buy/sell activity. Mobula does not guarantee taker attribution or the wallet identity used for unique counts. Missing or malformed upstream metrics are null; a reported zero remains zero.
        - `buy_volume_usd` string, nullable, required
        - `buyers` integer, nullable, required: Unique buyers reported by the provider.
        - `buys` integer, nullable, required: Provider-reported buy count.
        - `sell_volume_usd` string, nullable, required
        - `sellers` integer, nullable, required: Unique sellers reported by the provider.
        - `sells` integer, nullable, required: Provider-reported sell count.
      - `24h` ProductTokenTradeFlowWindowV1, required: Mobula-provided, token-relative buy/sell activity. Mobula does not guarantee taker attribution or the wallet identity used for unique counts. Missing or malformed upstream metrics are null; a reported zero remains zero.
        - `buy_volume_usd` string, nullable, required
        - `buyers` integer, nullable, required: Unique buyers reported by the provider.
        - `buys` integer, nullable, required: Provider-reported buy count.
        - `sell_volume_usd` string, nullable, required
        - `sellers` integer, nullable, required: Unique sellers reported by the provider.
        - `sells` integer, nullable, required: Provider-reported sell count.
      - `4h` ProductTokenTradeFlowWindowV1, required: Mobula-provided, token-relative buy/sell activity. Mobula does not guarantee taker attribution or the wallet identity used for unique counts. Missing or malformed upstream metrics are null; a reported zero remains zero.
        - `buy_volume_usd` string, nullable, required
        - `buyers` integer, nullable, required: Unique buyers reported by the provider.
        - `buys` integer, nullable, required: Provider-reported buy count.
        - `sell_volume_usd` string, nullable, required
        - `sellers` integer, nullable, required: Unique sellers reported by the provider.
        - `sells` integer, nullable, required: Provider-reported sell count.
      - `5m` ProductTokenTradeFlowWindowV1, required: Mobula-provided, token-relative buy/sell activity. Mobula does not guarantee taker attribution or the wallet identity used for unique counts. Missing or malformed upstream metrics are null; a reported zero remains zero.
        - `buy_volume_usd` string, nullable, required
        - `buyers` integer, nullable, required: Unique buyers reported by the provider.
        - `buys` integer, nullable, required: Provider-reported buy count.
        - `sell_volume_usd` string, nullable, required
        - `sellers` integer, nullable, required: Unique sellers reported by the provider.
        - `sells` integer, nullable, required: Provider-reported sell count.
    - `volume_1h_usd` string, nullable, required
    - `volume_24h_usd` string, nullable, required
    - `verified` boolean, nullable, required
  - `token_security` ProductTokenSecurityV1, required: Informational Birdeye security signals. Null means Birdeye did not provide that signal for the selected chain or token. A clean observation never means the token is safe and is never portfolio, quote, sell, or execution authority.
    - `asset` union, required
      - object
        - `address` string, required
        - `chain_id` 'solana:mainnet-beta', required
      - object
        - `address` string, required
        - `chain_id` 'eip155:1' | 'eip155:56' | 'eip155:143' | 'eip155:4663' | 'eip155:5042' | 'eip155:8453' | 'eip155:42161', required
    - `honeypot` boolean, nullable, required: Birdeye's EVM honeypot signal. Always null for Solana because Birdeye does not expose an isHoneypot field in its Solana security schema.
    - `observed_at_ms` string, required
    - `provider` 'birdeye', required
    - `scam_flag` boolean, nullable, required: Provider fake/scam-token signal when available; null is unknown, not clean.
    - `status` 'reviewed', required
    - `verification_source` 'jupiter_strict_list' | 'null', nullable, required: The community list used for verification. Currently Jupiter Strict List on Solana only.
    - `verified` boolean, nullable, required: Whether the token is on the named verification source. Null means no supported verification signal was available.

## Other responses

- `400`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `404`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `408`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `413`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `429`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `503`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.

---

[API](https://skmtc.dev/arbital/apis/arbital-api.md) - [All operations](https://skmtc.dev/arbital/apis/arbital-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arbital/apis/arbital-api/revisions/bb0185edf43a?raw)