Skip to content
ChordChordChord Docs

Relayer gas health

GET
/relayers
curl --request GET \
  --url 'https://api.getchord.xyz/v1/relayers?force=1'

For each chain Chord’s relayer pays gas on (Monad gasless swaps, Robinhood Permit2 swaps, Arc CCTP mints): its address, native balance, current gas price and the estimated transactions that balance still covers. ok = above the floor; the cross-chain planner stops routing through a relayer that is not ok.

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters”
force
string
Allowed values: 1

Re-read now instead of the 60 s cache.

Responses

Section titled “ Responses ”

200

Section titled “200”
Media typeapplication/json
object
minTx

The floor.

integer
relayers
Array<object>
object
chainId
integer
name
string
symbol
string
role
string
configured
boolean
address

EVM address, hex, case-insensitive.

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

Amount in the token’s smallest unit, as a decimal string. Never a float.

string | null
/^\d+$/
gasPrice

Amount in the token’s smallest unit, as a decimal string. Never a float.

string | null
/^\d+$/
gasPerTx
integer
txRemaining
integer | null
ok
boolean
checkedAt

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

integer
error
string
updatedAt

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

integer
Examplegenerated
{
  "minTx": 1,
  "relayers": [
    {
      "chainId": 1,
      "name": "example",
      "symbol": "example",
      "role": "example",
      "configured": true,
      "address": "example",
      "balance": "example",
      "gasPrice": "example",
      "gasPerTx": 1,
      "txRemaining": 1,
      "ok": true,
      "checkedAt": 1,
      "error": "example"
    }
  ],
  "updatedAt": 1
}