{"openapi":"3.1.0","info":{"title":"DeFi Signals API","version":"1.2.0","description":"Paid market-data API for AI agents (x402 / USDC on Base): cross-venue perpetual funding rates with an arbitrage spread signal, outlier-cleaned DeFi yields, and a low-cost market snapshot.","x-guidance":"All endpoints are GET and return clean JSON. Pay per request via x402 (exact scheme, USDC on Base, eip155:8453). Start with GET /market/snapshot ($0.002) for market context (BTC/ETH/SOL prices + Fear & Greed). Use GET /defi/funding-rates?symbol=BTC ($0.005) for cross-venue perp funding rates (OKX, Kraken Futures, dYdX) including spread_annualized_pp as a ready-made funding-arbitrage signal. Use GET /defi/yields?chain=Base ($0.01) for TVL-filtered, outlier-cleaned top DeFi yields from DefiLlama.","contact":{"email":"paulos@voiceagenten.com"}},"servers":[{"url":"https://defi-signals.org","description":"Production"}],"components":{"schemas":{"MarketSnapshot":{"type":"object","properties":{"prices":{"type":"object","properties":{"btc_usd":{"type":"number"},"eth_usd":{"type":"number"},"sol_usd":{"type":"number"}}},"change_24h_pct":{"type":"object","properties":{"btc":{"type":"number"},"eth":{"type":"number"},"sol":{"type":"number"}}},"fear_greed":{"type":"object","properties":{"value":{"type":"number"},"classification":{"type":"string"}}},"as_of":{"type":"string","format":"date-time"}},"required":["prices","fear_greed","as_of"]},"FundingRates":{"type":"object","properties":{"symbol":{"type":"string"},"venues":{"type":"array","items":{"$ref":"#/components/schemas/FundingVenue"}},"spread_annualized_pp":{"type":"number","description":"Spread between highest and lowest annualized funding rate, in percentage points — funding arbitrage signal"},"as_of":{"type":"string","format":"date-time"}},"required":["symbol","venues","spread_annualized_pp","as_of"]},"FundingVenue":{"type":"object","properties":{"venue":{"type":"string"},"rate":{"type":"number"},"interval_hours":{"type":"number"},"annualized_pct":{"type":"number"},"mark_price":{"type":["number","null"]}},"required":["venue","rate","interval_hours","annualized_pct"]},"TopYields":{"type":"object","properties":{"chain":{"type":"string"},"pools":{"type":"array","items":{"$ref":"#/components/schemas/YieldPool"}},"outliers_removed":{"type":"number"},"as_of":{"type":"string","format":"date-time"}},"required":["chain","pools","as_of"]},"YieldPool":{"type":"object","properties":{"project":{"type":"string"},"symbol":{"type":"string"},"apy_pct":{"type":"number"},"apy_base_pct":{"type":["number","null"]},"tvl_usd":{"type":"number"},"stable":{"type":"boolean"}},"required":["project","symbol","apy_pct","tvl_usd"]}}},"paths":{"/signals/daily":{"get":{"operationId":"getDailySignals","summary":"PREMIUM: one-call daily signal — market regime, yield deltas from proprietary history, funding-arbitrage setup, ranked opportunities","tags":["Signals","Data"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"market_signal":{"type":"object","properties":{"regime":{"type":"string"},"fear_greed":{"type":"number"},"btc_24h_pct":{"type":"number"},"read":{"type":"string"}}},"top_opportunities":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"note":{"type":"string"}}}},"yields_top10":{"type":"array","items":{"type":"object"}},"funding":{"type":"object"},"history":{"type":"object","properties":{"days_of_history":{"type":"number"},"deltas_available":{"type":"boolean"}}},"as_of":{"type":"string","format":"date-time"}},"required":["market_signal","top_opportunities","as_of"]}}}},"402":{"description":"Payment Required"}}}},"/market/snapshot":{"get":{"operationId":"getMarketSnapshot","summary":"Market snapshot: BTC/ETH/SOL prices, 24h change, Fear & Greed index","tags":["Data"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"parameters":[],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketSnapshot"}}}},"402":{"description":"Payment Required"}}}},"/defi/funding-rates":{"get":{"operationId":"getFundingRates","summary":"Cross-venue perpetual funding rates (OKX, Kraken Futures, dYdX) with arbitrage spread signal","tags":["Data","Trading"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"symbol","in":"query","required":false,"description":"Token symbol, e.g. BTC, ETH, SOL (default BTC)","schema":{"type":"string","default":"BTC","minLength":2,"maxLength":10}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundingRates"}}}},"402":{"description":"Payment Required"}}}},"/defi/yields":{"get":{"operationId":"getTopYields","summary":"Top DeFi yields per chain — TVL-filtered, outlier-cleaned (DefiLlama)","tags":["Data","DeFi"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"chain","in":"query","required":false,"description":"Chain name, e.g. Base, Ethereum, Arbitrum (default Base)","schema":{"type":"string","default":"Base"}},{"name":"min_tvl_usd","in":"query","required":false,"description":"Minimum pool TVL in USD (default 1000000)","schema":{"type":"number","default":1000000,"minimum":0}},{"name":"max_apy_pct","in":"query","required":false,"description":"Outlier cap: pools above this APY are excluded (default 300)","schema":{"type":"number","default":300,"minimum":1}},{"name":"limit","in":"query","required":false,"description":"Max number of pools (default 10, max 25)","schema":{"type":"number","default":10,"maximum":25}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopYields"}}}},"402":{"description":"Payment Required"}}}}}}