# Venue share over a window

`GET https://api.getchord.xyz/v1/arc/venues`

Source: https://getchord.xyz/docs/api-reference/operations/arcvenues/

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.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `days` | query | no | integer (default `30`) | Window length. |

## Response 200

Example (captured from the live API):

```json
{
  "chain": 5042,
  "days": 2,
  "since": 1789776000,
  "venues": [
    {
      "dex": "uniswap_v4",
      "volUsd": 68035852.94572023,
      "trades": 984421,
      "sharePct": 75.67924527197266,
      "series": [
        {
          "day": 1789776000,
          "volUsd": 58377642.50907503,
          "trades": 798150,
          "tokens": 4499
        },
        {
          "day": 1789862400,
          "volUsd": 9658210.4366452,
          "trades": 186271,
          "tokens": 1536
        }
      ]
    },
    {
      "dex": "uniswap_v3",
      "volUsd": 18354272.62782195,
      "trades": 133374,
      "sharePct": 20.41625760314611,
      "series": [
        {
          "day": 1789776000,
          "volUsd": 14284128.68933594,
          "trades": 103080,
          "tokens": 2418
        },
        {
          "day": 1789862400,
          "volUsd": 4070143.9384860075,
          "trades": 30294,
          "tokens": 728
        }
      ]
    }
  ],
  "totals": {
    "volUsd": 89900279.3978931,
    "trades": 1135137
  },
  "updatedAt": 1789891853672
}
```

- **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.