AgenticFi API
DeFi APIs for AI agents. 36 pay-per-call endpoints for token data, pricing, wallet analytics, swap routing, and on-chain workflows. Powered by x402 on Base.
v2 ยท https://defi-api.agenticfi.wtfDiscovery
Health
Paid Endpoints
- GET /api/token/price/:idOrSymbol - Real-time token price by CoinGecko ID or symbol - includes 24h change, volume, market cap [$0.001] [eip155:8453] [token-price, real-time, market-data]
- GET /api/token/price-history/:id - OHLCV candles for a token - supports 1d, 7d, 14d, 30d, 90d, 365d ranges [$0.001] [eip155:8453] [ohlcv, price-history, candles]
- GET /api/token/info/:address - EVM token info by contract address or native asset - metadata, realtime price, supply fields, logo, and optional historical prices [$0.001] [eip155:8453] [token-info, metadata, pricing, historical-prices, sim]
- GET /api/token/holders/:chainId/:address - ERC-20 token holders by chain - ranked by balance descending with first-acquired and transfer-initiation flags [$0.001] [eip155:8453] [token-holders, distribution, erc20, holders, sim]
- GET /api/token/metadata/:id - Token metadata - name, symbol, decimals, logo, chains, links [$0.001] [eip155:8453] [token-metadata, token-info]
- GET /api/token/trending - Top trending tokens by search volume and social activity [$0.001] [eip155:8453] [trending, social, popular]
- GET /api/token/supply/:id - Circulating, total, max supply + FDV for a token [$0.001] [eip155:8453] [supply, tokenomics, fdv]
- GET /api/token/pairs/:id - All DEX pairs for a token with liquidity data [$0.001] [eip155:8453] [dex-pairs, liquidity, trading]
- GET /api/defi/protocol-tvl - TVL by protocol - top 50 or specific protocol with chain breakdown [$0.001] [eip155:8453] [tvl, protocol, defi]
- GET /api/defi/yields - Top yield pools across all protocols and chains - sorted by APY [$0.001] [eip155:8453] [yields, apy, farming]
- GET /api/defi/pool-details/:poolId - Detailed pool info - APY history, TVL, IL risk, reward tokens [$0.001] [eip155:8453] [pool, apy-history, il-risk]
- GET /api/defi/lending-rates - Supply & borrow rates across Aave, Compound, Morpho, Spark [$0.001] [eip155:8453] [lending, borrow-rates, supply-rates]
- GET /api/defi/stablecoin-stats - Stablecoin market caps, peg deviations, circulating supply by chain [$0.001] [eip155:8453] [stablecoins, peg, circulating]
- GET /api/defi/dex-volume - 24h DEX trading volume by chain and protocol [$0.001] [eip155:8453] [dex-volume, trading-volume, dex]
- GET /api/defi/protocol-fees - Revenue and fees by protocol - daily fees and protocol revenue [$0.001] [eip155:8453] [fees, revenue, protocol-revenue]
- GET /api/wallet/balances/:address - EVM token balances for a wallet - native + ERC-20 with Sim pricing, warnings, pagination, and optional historical prices [$0.001] [eip155:8453] [wallet, balances, portfolio, sim]
- GET /api/wallet/activity/:address - EVM wallet activity feed - newest-first transfers, swaps, approvals, NFT movements, and decoded contract calls [$0.001] [eip155:8453] [activity, wallet-activity, transfers, swaps, sim]
- GET /api/wallet/transactions/:address - EVM transactions for a wallet - raw transaction fields, gas data, pagination, and optional decoded calldata and logs [$0.001] [eip155:8453] [transactions, wallet-transactions, gas, decoded, sim]
- GET /api/wallet/history/:address - Transaction history - decoded actions with method labels [$0.001] [eip155:8453] [tx-history, transactions, decoded]
- GET /api/wallet/collectibles/:address - EVM collectibles for a wallet - ERC-721 and ERC-1155 holdings with spam filtering, pagination, and optional spam score explanations [$0.001] [eip155:8453] [collectibles, nfts, erc721, erc1155, sim]
- GET /api/wallet/nfts/:address - NFTs held by a wallet - collection, floor price, metadata [$0.001] [eip155:8453] [nfts, wallet-nfts, collections]
- GET /api/wallet/defi-positions/:address - Active DeFi positions - lending, LP, staking across protocols [$0.001] [eip155:8453] [defi-positions, lending, staking, lp]
- GET /api/swap/quote - Best swap route + price across DEX aggregators via LI.FI [$0.001] [eip155:8453] [swap, dex-aggregator, quote]
- GET /api/bridge/quote - Cross-chain bridge quote - route, fee, ETA via LI.FI [$0.001] [eip155:8453] [bridge, cross-chain, quote]
- GET /api/gas/prices - Gas prices across EVM chains - fast, standard, slow in gwei [$0.001] [eip155:8453] [gas, gas-price, evm]
- GET /api/gas/estimate - Gas estimate for a transaction type - transfer, swap, bridge, mint, etc. [$0.001] [eip155:8453] [gas-estimate, transaction-cost]
- GET /api/swap/slippage-check - Simulated swap to detect MEV/sandwich risk and actual slippage [$0.001] [eip155:8453] [slippage, mev, sandwich-attack]
- GET /api/bridge/status - Track a bridge transaction - pending, confirmed, complete [$0.001] [eip155:8453] [bridge-status, tracking, cross-chain]
- GET /api/analytics/chain-stats - Chain-level stats - TVL, active chains, token symbols [$0.001] [eip155:8453] [chain-stats, network-stats, tps]
- GET /api/chain/supported - List all supported chains with RPCs, explorers, native tokens [$0.001] [eip155:8453] [chains, supported-networks, multichain]
- GET /api/chain/token-list/:chainId - Canonical token addresses and metadata per chain [$0.001] [eip155:8453] [token-list, addresses, canonical]
- GET /api/chain/block-height/:chain - Latest block number for a chain [$0.001] [eip155:8453] [block-height, latest-block, finality]
- GET /api/social/token-mentions/:symbol - Social volume - Twitter/Farcaster mention count for a token [$0.001] [eip155:8453] [social-mentions, twitter, farcaster]
- GET /api/social/sentiment/:symbol - Bullish/bearish sentiment score per token [$0.001] [eip155:8453] [sentiment, bullish-bearish, social-score]
- GET /api/agent/portfolio-rebalance/:address - Suggested portfolio rebalance based on current holdings + yield opportunities [$0.001] [eip155:8453] [rebalance, portfolio, yield-optimization, agent]
- GET /api/agent/tx-summary/:txHash - Lightweight transaction summary from raw RPC data - action label, counterparties, status, gas, and log count [$0.001] [eip155:8453] [tx-summary, rpc, selector-label, agent]