---
title: "GET /v2/market/trades/ws"
method: GET
path: "/v2/market/trades/ws"
tags: ["Product Market Realtime"]
---

# GET /v2/market/trades/ws

`GET /v2/market/trades/ws`

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

Upgrades to a pooled Birdeye live on-chain trade stream for one canonical token. Arc is intentionally unsupported and returns terminal HTTP 422 live_token_trades_unsupported; use its Mobula REST history. Connect before loading history, then deduplicate by event_id. No replay: reconnecting, disconnect or consumer_lagged requires bounded history reseed without claiming complete missed-event delivery. Provider/capacity failures permit bounded retry.

## Query parameters

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

## Other responses

- `101`: Live token trade WebSocket protocol upgrade accepted
- `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.
- `422`: Permanent live capability gap: live_token_trades_unsupported. Do not retry this live subscription; REST history remains independent.
- `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)