Get Pool Yields
Look up real LP-pool APYs from DefiLlama Yields, filtered by chain, protocol, and tokens. Returns each pool's fee APR (apyBase), incentive APR (apyReward), total apy, 7-day APY change, TVL, and 24h volume — sorted and limited in memory; APY fields are passed through untouched (may be null). Ideal for: finding the highest-yielding pools for a token pair, comparing fee vs incentive APR across protocols, spotting pools whose APY dropped over the last week.
Catalog action Blockchain Data
Look up real LP-pool APYs from DefiLlama Yields, filtered by chain, protocol, and tokens. Returns each pool's fee APR (apyBase), incentive APR (apyReward), total apy, 7-day APY change, TVL, and 24h volume — sorted and limited in memory; APY fields are passed through untouched (may be null). Ideal for: finding the highest-yielding pools for a token pair, comparing fee vs incentive APR across protocols, spotting pools whose APY dropped over the last week.
At a Glance
| Field | Value |
|---|---|
| Action ID | defillama-get-pool-yields |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | defi, yield, apy, pool, liquidity, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
chains | array | No | Filter by chain. Case-insensitive names + aliases (eth/ethereum→Ethereum, arb→Arbitrum, base, rh/robinhood→Robinhood Chain, op/optimism→OP Mainnet, polygon/matic, bsc/bnb, avax). Unrecognized values match pool.chain case-insensitively. |
projects | array | No | Filter by protocol. A pool matches if its project equals OR starts with the value (uni/uniswap matches all uniswap versions; aerodrome matches aerodrome-v1 and aerodrome-slipstream). |
tokens | array | No | Filter by tokens in the pool symbol (order-independent). A pool matches if its symbol contains ALL provided tokens, e.g. ['WETH','USDC'] matches 'USDC-WETH'. |
minTvlUsd | number | No | Drop pools below this TVL in USD (default: 10000). |
minApy | number | No | Keep only pools with total apy >= this value (percent). |
stablecoinOnly | boolean | No | Keep only pools flagged as stablecoin pools. |
sortBy | string | No | Field to sort pools by, descending. Nulls sink to the bottom (default: apy). |
limit | number | No | Maximum number of pools to return (default: 20, min: 1, max: 100). |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
pools | array | Yes | Matching pools after sort + limit. |
count | number | Yes | Number of pools returned (after limit) |
totalMatched | number | Yes | Number of pools matching filters (before limit) |
Examples
json{ "type": "defillama-get-pool-yields", "payload": { "chains": [], "projects": [], "tokens": [ "ETH" ], "minTvlUsd": 10000, "minApy": 1 }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/defillama-get-pool-yields/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "chains": [], "projects": [], "tokens": [ "ETH" ], "minTvlUsd": 10000, "minApy": 1 }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.