---
title: "Venue share over a window"
method: GET
path: "/arc/venues"
tags: ["Arc data"]
---

# Venue share over a window

`GET /arc/venues`

## Request

- Base URL: `https://api.getchord.xyz/v1`
- URL: `https://api.getchord.xyz/v1/arc/venues`
- Auth: none declared

Per-venue volume, trades and share for 1–180 days, with a daily series per venue. Venue ids are listed under Resources → Venue ids.

Served from Chord's rollup and index tables (every swap on Arc summed by hour, token and venue), never from a raw scan — so calls are cheap and every answer carries its coverage. No key needed. `503 NOT_READY` until the rollup has run on the deployment.

## Query parameters

- `days` integer

## Response `200`

- object
  - `chain` 5042
  - `days` integer
  - `since` integer: Unix time, seconds, UTC.
  - `venues` object[]
    - `dex` string
    - `volUsd` number
    - `trades` integer
    - `sharePct` number
    - `series` object[]
      - `day` integer
      - `volUsd` number
      - `trades` integer
      - `tokens` integer
  - `totals` object
    - `volUsd` number
    - `trades` integer
  - `updatedAt` integer: Unix time, milliseconds — when the server built this answer.

## Other responses

- `400`: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).
- `503`: The lane behind this endpoint is not ready or not enabled here (`NOT_READY`, `CHAIN_NOT_ENABLED`, `NOT_ENABLED`, `*_UNAVAILABLE`). Retry later; do not treat it as an empty answer.

---

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