vfat.io APIvfat.io ↗
Access yield farming APRs, TVL, token prices, lending markets, and wallet portfolios across 30+ blockchains via the vfat.io API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/f29e46fc-b478-4aa1-9565-d097147f898d/get_chains' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the list of supported blockchains on vfat.io, including RPC URLs, contract addresses, and native currency details.
No input parameters required.
{
"type": "array",
"fields": {
"sickle": "object with factory/registry contract addresses",
"chainId": "integer blockchain chain ID",
"chainName": "string blockchain name",
"nativeCurrency": "object with address, name, symbol, decimals",
"wrappedNativeToken": "object with name, symbol, address, decimals"
},
"sample": {
"data": [
{
"chainId": 8453,
"feeModel": "op_stack",
"chainName": "Base",
"nativeCurrency": {
"name": "Ether",
"symbol": "ETH",
"address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"decimals": 18
},
"wrappedNativeToken": {
"name": "Wrapped Ether",
"symbol": "WETH",
"address": "0x4200000000000000000000000000000000000006",
"decimals": 18
}
}
],
"status": "success"
}
}About the vfat.io API
The vfat.io API provides 11 endpoints covering DeFi yield farming farms, token data, lending markets, and wallet portfolio positions across 30+ blockchains. Use get_farms to retrieve paginated farm listings sorted by TVL with APR metrics, or get_portfolio to pull a wallet's native token balances, farm positions, and compound lending exposure in a single call. Response fields include chain IDs, contract addresses, underlying token compositions, and pending rewards.
Farm and Token Data
The get_farms endpoint returns a paginated list of yield farms sorted by TVL descending. Each farm object includes id, type (e.g. AERODROME_V2, AERO_SLIPSTREAM_GAUGE), chainId, address, protocol, pool, apr, and TVL metrics. You can filter results by chain_id (e.g. 8453 for Base, 1 for Ethereum) or search directly by farm contract address. For deeper detail on a single farm, get_farm_detail returns pool composition with underlying tokens, activeLiquidity in USD, and the full protocol object. The get_tokens endpoint lists tracked tokens sorted by liquidity, exposing price, percentChange24h, and liquidity per token. get_token_detail extends this with the DEX liquidity pools associated with a given token contract.
Portfolio and Wallet Tracking
get_portfolio accepts any wallet address and returns balances (token holdings across chains), farm_balances (yield farming positions), compound_borrows, and compound_balances (lending supply positions) in one response. get_portfolio_chains narrows this to a per-chain USD breakdown, returning only chains where the wallet holds non-zero balances. get_yield_deposits targets vfat-tracked farm deposits specifically, returning farm type, LP token price, underlying token balances, pendingRewards, and farmAddress for each active position.
Lending Markets and Platform Stats
get_lending_markets lists compound-style DeFi lending markets across all supported chains. Each entry includes symbol, chainId, totalCash, totalBorrow, marketAddress, and an underlying object with token price. get_platform_stats exposes platform-wide aggregates: total tvl, uniqUsers, nbPositions, and per-chain breakdowns via chainStats. For monitoring data freshness, get_data_freshness reports blockLag, timeLagSeconds, and computedAt timestamps per chain, which is useful for applications that need to understand how current the aggregated on-chain data is.
- Aggregate top yield farms by TVL across Ethereum, Base, and other chains using
get_farmswithchain_idfiltering. - Display a DeFi wallet dashboard showing token balances, farm positions, and lending exposure via
get_portfolio. - Track pending farm rewards and underlying LP token compositions for a specific wallet using
get_yield_deposits. - Compare lending market supply and borrow totals across chains with
get_lending_markets. - Monitor 24-hour token price changes and liquidity rankings using
get_tokens. - Build a chain-by-chain portfolio allocation view using
get_portfolio_chainsUSD balances. - Alert on stale data pipelines by polling
get_data_freshnessfortimeLagSecondsper chain.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does vfat.io have an official developer API?+
What does `get_farm_detail` return that `get_farms` does not?+
get_farms returns summary-level fields suitable for listing — apr, tvl metrics, type, and protocol. get_farm_detail adds pool composition with underlying tokens, activeLiquidity in USD, and a more complete protocol object. It requires both address and chain_id as inputs and returns data for a single farm.How current is the data returned by these endpoints?+
get_data_freshness endpoint exposes blockLag (number of blocks behind the latest), timeLagSeconds, and a computedAt ISO timestamp for each supported chain. Applications that require strict latency guarantees should poll this endpoint to verify lag before acting on farm or portfolio data.Does the API expose historical farm APR or TVL time series data?+
get_farms, current token prices from get_tokens, and current lending totals from get_lending_markets. No historical time-series endpoints are included. You can fork this API on Parse and revise it to add a historical data endpoint if the underlying source exposes it.Can I filter `get_tokens` by chain or search by token symbol?+
get_tokens endpoint currently accepts only page and page_size as inputs and returns all tracked tokens sorted by liquidity. There is no chain_id or symbol filter on this endpoint. get_token_detail supports per-chain lookup by contract address and chain_id. You can fork this API on Parse and revise it to add symbol or chain filtering to the token list endpoint.