Skip to content
ChordChordChord Docs

One token: hourly tape and venue split

GET
/rh/token/{address}
curl --request GET \
  --url 'https://api.getchord.xyz/v1/rh/token/example?hours=168'

Chain 4663 only; takes no chain parameter. Served from Chord’s rollup tables, never from a raw scan. 503 NOT_READY until the rollup has run.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
address
required

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/

Query Parameters

Section titled “Query Parameters”
hours
integer
default: 168 >= 1 <= 720

Responses

Section titled “ Responses ”

200

Section titled “200”
Media typeapplication/json
object
token
object
address

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/
symbol
string | null
series
Array<object>
object
hour
integer
volUsd
number
buyUsd
number
sellUsd
number
trades
integer
buys
integer
sells
integer
priceLast
number | null
byDex
Array<object>
object
dex
string
volUsd
number
trades
integer
sharePct
number
Examplegenerated
{
  "token": {
    "address": "example",
    "symbol": "example"
  },
  "series": [
    {
      "hour": 1,
      "volUsd": 1,
      "buyUsd": 1,
      "sellUsd": 1,
      "trades": 1,
      "buys": 1,
      "sells": 1,
      "priceLast": 1
    }
  ],
  "byDex": [
    {
      "dex": "example",
      "volUsd": 1,
      "trades": 1,
      "sharePct": 1
    }
  ]
}

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"
}