Discovery and markets API
Is each liquid-staking ETH token trading at, above or below its redemption rate?
Every liquid-staking ETH token: the ETH its contract redeems it for, the ETH the market pays, the gap in percent and the protocol fee. No chain, no input.
/api/external/discovery/lst-pegsWhat it returns
Every liquid-staking ETH token in one call: the ETH its contract redeems it for, the ETH the market pays for it, the gap between the two in percent, and the protocol's fee. A negative pegPercent is a discount to the redemption rate, a positive one a premium. Most tokens have no executable market quote — marketRate and pegPercent are null for them, never 0, and priced says how many of the total carry one. symbol is not unique; address is.
Chains
This endpoint is not tied to a chain: it takes no chain in its request.
Request
Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.
curl -H "x-dex-data-key: $DEXDATA_API_KEY" \ "https://api.dexdata.io/api/external/discovery/lst-pegs"
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
total | integer | Liquid-staking tokens in the answer. |
priced | integer | How many of them carry a market rate, and so a peg. |
tokens | object[] | Each token, in the order the source ranks them. |
tokens[].name | string | The protocol behind the token, e.g. Lido. |
tokens[].symbol | string | The ticker, e.g. stETH. Not unique — rETH is two different tokens. |
tokens[].address | string | The token contract on Ethereum. The unique key of a row. |
tokens[].accounting | string | accruing: the token is worth more ETH over time. rebase: the balance grows and the rate stays 1. |
tokens[].redemptionRate | number | ETH the contract redeems one token for. Always 1 for a rebase token. |
tokens[].marketRate | number | null | ETH the market pays for one token. Null when no executable quote is published. |
tokens[].pegPercent | number | null | How far the market rate sits from the redemption rate, in percent: -0.81 is 0.81% below it, a positive value above. Null without a market rate. |
tokens[].feePercent | number | null | The protocol's cut of the staking rewards, in percent (0.1 = 0.1%). Null when not published. |
Start building with DexData today
Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.
Get a free API key