Onchain

Yield Pool Ranking

List individual DeFi yield pools ranked by APY or TVL. Example: filter by protocol like lido or aave for pool-level yield data.

get/gateway/v1/onchain/yield/ranking

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

projectstring

Filter by protocol name like lido, aave, or uniswap

Example:aave
sort_by'apy' | 'tvl_usd'

Ranking metric: apy or tvl_usd. When sorted by apy, only pools with TVL >= $100k are included

Example:apy
order'asc' | 'desc'

Sort direction

Example:desc
limitinteger

Results per page

Example:20
offsetinteger

Pagination offset

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseYieldRankingItem.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.