---
title: "GET /v2/market/surge"
method: GET
path: "/v2/market/surge"
tags: ["Product Market"]
---

# GET /v2/market/surge

`GET /v2/market/surge`

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

Returns GMGN positive token-signal market-cap moves for the selected window, ranked by change. Arc is intentionally unsupported. Omit chain_id to merge all supported chains. Values are display-only observations and never execution authority.

## Query parameters

- `chain_id` 'solana:mainnet-beta' | 'eip155:56' | 'eip155:4663'
- `interval` '1m' | '5m' | '1h' | '6h' | '24h'
- `limit` integer

## Response `200`

A cached Surge snapshot ranked by positive market-cap change

- ProductMarketSurgeResponseV1
  - `available_chain_ids` solana:mainnet-beta,eip155:56,eip155:4663, required
    - unknown
  - `chain_id` 'solana:mainnet-beta' | 'eip155:56' | 'eip155:4663', nullable, required
  - `freshness` 'fresh' | 'stale', required
  - `interval` '1m' | '5m' | '1h' | '6h' | '24h', required
  - `items` ProductMarketSurgeTokenV1[], 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
    - `change_pct` string, required
    - `first_trigger_market_cap_usd` string, nullable, required
    - `holders_count` string, nullable, required
    - `image_url` string, uri, nullable, required
    - `liquidity_usd` string, nullable, required
    - `market_cap_usd` string, required
    - `name` string, nullable, required
    - `price_usd` string, nullable, required
    - `rank` integer, required
    - `signal_count` string, nullable, required
    - `symbol` string, nullable, required
    - `top_10_holder_pct` string, nullable, required
    - `trigger_at_ms` string, required
    - `trigger_market_cap_usd` string, required
  - `observed_at_ms` string, 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.
- `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)