Skip to content
ChordChordChord Docs

Venue share over a window

GET
/arc/venues
curl --request GET \
  --url 'https://api.getchord.xyz/v1/arc/venues?days=30'

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

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters”
days
integer
default: 30 >= 1 <= 180

Window length.

Responses

Section titled “ Responses ”

200

Section titled “200”
Media typeapplication/json
object
chain
integer
Allowed value: 5042
days
integer
since

Unix time, seconds, UTC.

integer
venues
Array<object>
object
dex
string
volUsd
number
trades
integer
sharePct
number
series
Array<object>
object
day
integer
volUsd
number
trades
integer
tokens
integer
totals
object
volUsd
number
trades
integer
updatedAt

Unix time, milliseconds — when the server built this answer.

integer
Example
{
  "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

Section titled “400”

Invalid parameters — error names the check that failed (INVALID_PARAMS, BAD_ADDRESS, BAD_LIMIT, BAD_HOURS, …).

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}

503

Section titled “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.

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}