DeFi Intelligence

16 endpoints for on-chain analytics, token prices, swap quotes, portfolio tracking, DeFi positions, wallet profiling, and smart contract reads. Each call is a real x402 micropayment ($0.001–$0.015 USDC).

How to call endpoints

bash {baseDir}/scripts/defi.sh METHOD ENDPOINT '{"key":"value"}'

GET endpoints pass JSON as query params. POST endpoints send JSON body.

Workflow strategies

Token research — get prices, check swap quotes across DEXes, look up the contract via contract/read, resolve any ENS names involved.

Wallet profiling — resolve ENS to address, pull balances, get wallet analytics (activity tier, risk signals), check portfolio tokens and NFTs, review DeFi positions, pull tx history.

Yield analysis — check DeFi positions for an address, get token prices to calculate USD values, compare swap rates for entry/exit.

Market monitoring — use oracle/prices for aggregated feeds, oracle/gas for chain congestion, oracle/fx for stablecoin depegs, prices for quick multi-token lookups.

Due diligence — combine wallet analytics (risk signals) with tx history, portfolio composition, and DeFi position exposure for a complete profile.

Always include token symbols, USD values, and chain context in your responses. Format large numbers with commas.

Available endpoints (16 tools)

Price & Oracle Data

Oracle Prices — $0.008

Aggregated oracle price feed across multiple sources.

bash {baseDir}/scripts/defi.sh GET /api/v1/oracle/prices '{"symbols":"ETH,BTC,SOL"}'

Token Prices — $0.002

Multi-token price feed across major assets. Cached, low-latency.

bash {baseDir}/scripts/defi.sh GET /api/v1/prices '{"symbols":"ETH,BTC,USDC"}'

Gas Prices — $0.005

Real-time gas prices for Base and other supported EVM chains.

bash {baseDir}/scripts/defi.sh GET /api/v1/oracle/gas '{"chain":"base"}'

Stablecoin FX — $0.008

Stablecoin FX rates: USDC, USDT, DAI, EURC, pyUSD, and more.

bash {baseDir}/scripts/defi.sh GET /api/v1/oracle/fx '{}'

Swap Intelligence

Swap Quote — $0.008

Get a swap quote across Uniswap V3, Aerodrome, and other DEXes on Base.

bash {baseDir}/scripts/defi.sh GET /api/v1/swap/quote '{"tokenIn":"USDC","tokenOut":"ETH","amount":"1000"}'

Swap Tokens — $0.001

List supported swap tokens with addresses, decimals, and metadata.

bash {baseDir}/scripts/defi.sh GET /api/v1/swap/tokens '{}'

Wallet Analytics

Wallet Profile — $0.01

Wallet profile: balances, top tokens, activity tier, age, risk signals.

bash {baseDir}/scripts/defi.sh GET /api/v1/analytics/wallet '{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}'

Transaction History — $0.008

Transaction history for any address across supported chains.

bash {baseDir}/scripts/defi.sh GET /api/v1/analytics/txhistory '{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}'

Balances — $0.005

Multi-chain balance lookup for any address.

bash {baseDir}/scripts/defi.sh GET /api/v1/balances '{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}'

Portfolio & DeFi

Portfolio Tokens — $0.005

Full token portfolio for an address across supported chains.

bash {baseDir}/scripts/defi.sh GET /api/v1/portfolio/tokens '{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}'

Portfolio NFTs — $0.005

NFT holdings for an address across supported chains.

bash {baseDir}/scripts/defi.sh GET /api/v1/portfolio/nfts '{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}'

DeFi Positions — $0.008

Open DeFi positions across supported protocols — lending, staking, LP, vaults.

bash {baseDir}/scripts/defi.sh GET /api/v1/defi/positions '{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}'

Identity & Contracts

ENS Resolution — $0.002

Resolve an ENS name, Basename, or address to its canonical identity.

bash {baseDir}/scripts/defi.sh GET /api/v1/resolve '{"name":"vitalik.eth"}'

Read Contract — $0.002

Read from any smart contract via a view/pure function call.

bash {baseDir}/scripts/defi.sh POST /api/v1/contract/read '{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","function":"totalSupply","chain":"base"}'

Execution

Execute Swap — $0.015

Execute a token swap on Base via the MangoSwap router. Use swap/quote first to preview.

bash {baseDir}/scripts/defi.sh POST /api/v1/swap/execute '{"tokenIn":"USDC","tokenOut":"ETH","amount":"100","slippage":0.5}'

Write Contract — $0.01

Submit a state-changing smart contract transaction. Use with caution.

bash {baseDir}/scripts/defi.sh POST /api/v1/contract/write '{"address":"0x...","function":"approve","args":["0x...",1000000],"chain":"base"}'

Cost reference

Data sourced from Alchemy, CoinGecko, Uniswap V3, Aerodrome, and on-chain indexers.