---
title: "POST /v2/market/tokens/summaries"
method: POST
path: "/v2/market/tokens/summaries"
tags: ["Product Market"]
---

# POST /v2/market/tokens/summaries

`POST /v2/market/tokens/summaries`

## 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/summaries`
- Auth: none declared

Returns lightweight token detail projections for up to 20 unique canonical assets. Input order is preserved and provider failures are represented independently per item.

## Request body

- ProductMarketTokenSummariesRequestV1
  - `assets` ProductMarketAssetV1[], required
    - union
      - 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

## Response `200`

Ordered token summaries and per-asset resolution statuses

- ProductMarketTokenSummariesResponseV1
  - `items` ProductMarketTokenSummaryV1[], required
    - union
      - ProductMarketTokenSummaryOkV1
        - `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` ProductTokenSummaryEvidenceV1: Projection over summary fields only: never claims decimals, funding, token security or a complete detail cache. Evidence absence is supported for prior compatible backend releases.
          - `scope` 'token_summary', required
          - `served_at_ms` string, required
          - `groups` ProductTokenSummaryFactGroupEvidenceV1[], required
            - `scope` 'base' | 'metadata' | 'price', 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
              - …
        - `circulating_supply` string, nullable, required
        - `image_url` string, uri, nullable, required
        - `liquidity_usd` string, nullable, required
        - `market_cap_usd` string, nullable, required
        - `name` string, nullable, required
        - `observed_at_ms` string, required
        - `price_change_24h_pct` string, nullable, required
        - `price_usd` string, nullable, required
        - `status` 'ok', required
        - `symbol` string, nullable, required
        - `volume_24h_usd` string, nullable, required
      - ProductMarketTokenSummaryNotFoundV1
        - `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
        - `status` 'not_found', required
      - ProductMarketTokenSummaryRateLimitedV1
        - `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
        - `retry_after_seconds` integer, required
        - `status` 'rate_limited', required
      - ProductMarketTokenSummaryUnavailableV1
        - `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
        - `status` 'unavailable', required

## 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.
- `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.

---

[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)