{"openapi":"3.1.0","info":{"title":"PayFlow Datafeed API","version":"1.0.0","description":"Market & on-chain data proxy (DeFiLlama): DeFi yield pools, per-chain TVL, live token prices. Free probe at /v1/sample; full endpoints are pay-per-call in USDC via the x402 protocol (HTTP 402).","x-pricing":{"yields":0.01,"yieldOpportunities":0.02,"prices":0.005,"chains":0.01,"currency":"USDC"}},"servers":[{"url":"https://data.payflowagent.net"}],"paths":{"/v1/sample":{"get":{"operationId":"getSample","summary":"Free sample (no payment)","description":"Free, rate-limited: top DeFi yield pools by APY plus a 3-item yield-opportunity preview (score + reasons).","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5,"default":5}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","example":"Base"}},{"name":"profile","in":"query","required":false,"schema":{"type":"string","enum":["stable","balanced","aggressive"],"default":"stable"}}],"responses":{"200":{"description":"Sample pools + opportunity preview","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SampleResponse"}}}},"429":{"description":"Rate limit exceeded"}}}},"/v1/yields":{"get":{"operationId":"getYields","summary":"Ranked DeFi yield pools (paid via x402)","description":"Paid (x402, USDC). Filterable, ranked DeFi yield pools (chain, project, minTvl, minApy, stable).","x-402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetSymbol":"USDC","scheme":"exact","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","payTo":"0x617122b245C776A6B83A1f2821617819E2d38F6b"},"parameters":[{"name":"chain","in":"query","required":false,"schema":{"type":"string","example":"Ethereum"}},{"name":"project","in":"query","required":false,"schema":{"type":"string","example":"aave-v3"}},{"name":"minTvl","in":"query","required":false,"schema":{"type":"number","example":1000000}},{"name":"minApy","in":"query","required":false,"schema":{"type":"number","example":5}},{"name":"stable","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":25}}],"responses":{"200":{"description":"Ranked pools","content":{"application/json":{"schema":{"$ref":"#/components/schemas/YieldList"}}}},"402":{"description":"Payment Required (x402)."}}}},"/v1/yield-opportunities":{"get":{"operationId":"getYieldOpportunities","summary":"Ranked yield opportunities with risk score (paid via x402)","description":"Paid (x402, USDC). Agent-ready yield picks with score (0-100), rank, and explainable reasons. Profiles: stable (default), balanced, aggressive.","x-402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetSymbol":"USDC","scheme":"exact","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","payTo":"0x617122b245C776A6B83A1f2821617819E2d38F6b"},"parameters":[{"name":"profile","in":"query","required":false,"schema":{"type":"string","enum":["stable","balanced","aggressive"],"default":"stable"}},{"name":"chain","in":"query","required":false,"schema":{"type":"string","example":"Base"}},{"name":"minTvl","in":"query","required":false,"schema":{"type":"number","example":1000000}},{"name":"minApy","in":"query","required":false,"schema":{"type":"number","example":3}},{"name":"stable","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":25,"default":10}}],"responses":{"200":{"description":"Ranked opportunities","content":{"application/json":{"schema":{"$ref":"#/components/schemas/YieldOpportunityList"}}}},"400":{"description":"Invalid query parameters"},"402":{"description":"Payment Required (x402)."}}}},"/v1/prices":{"get":{"operationId":"getPrices","summary":"Current token prices (paid via x402)","description":"Paid (x402, USDC). Current USD prices for a list of DeFiLlama coin ids ({chain}:{address} or coingecko:{id}).","x-402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetSymbol":"USDC","scheme":"exact","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","payTo":"0x617122b245C776A6B83A1f2821617819E2d38F6b"},"parameters":[{"name":"coins","in":"query","required":true,"schema":{"type":"string","example":"coingecko:ethereum,coingecko:bitcoin"}}],"responses":{"200":{"description":"Prices","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceList"}}}},"400":{"description":"Missing/invalid coins"},"402":{"description":"Payment Required (x402)."}}}},"/v1/chains":{"get":{"operationId":"getChains","summary":"Per-chain TVL ranking (paid via x402)","description":"Paid (x402, USDC). TVL ranking across all chains.","x-402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetSymbol":"USDC","scheme":"exact","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","payTo":"0x617122b245C776A6B83A1f2821617819E2d38F6b"},"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"Chain TVL ranking","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainList"}}}},"402":{"description":"Payment Required (x402)."}}}}},"components":{"schemas":{"YieldList":{"type":"object","properties":{"asOf":{"type":"string","format":"date-time"},"count":{"type":"integer"},"pools":{"type":"array","items":{"$ref":"#/components/schemas/YieldPool"}}}},"SampleResponse":{"allOf":[{"$ref":"#/components/schemas/YieldList"},{"type":"object","properties":{"sample":{"type":"boolean","const":true},"profile":{"type":"string","enum":["stable","balanced","aggressive"]},"opportunityPreview":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/YieldPool"},{"type":"object","properties":{"score":{"type":"integer"},"rank":{"type":"integer"},"reasons":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"impact":{"type":"integer"},"detail":{"type":"string"}}}}}}]}},"upsell":{"type":"string"}}}]},"YieldOpportunityList":{"type":"object","properties":{"asOf":{"type":"string","format":"date-time"},"profile":{"type":"string","enum":["stable","balanced","aggressive"]},"count":{"type":"integer"},"opportunities":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/YieldPool"},{"type":"object","properties":{"score":{"type":"integer","minimum":0,"maximum":100},"rank":{"type":"integer","minimum":1},"reasons":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"impact":{"type":"integer"},"detail":{"type":"string"}}}}},"required":["score","rank","reasons"]}]}}}},"YieldPool":{"type":"object","properties":{"pool":{"type":"string"},"chain":{"type":"string"},"project":{"type":"string"},"symbol":{"type":"string"},"tvlUsd":{"type":"number"},"apy":{"type":"number"},"apyBase":{"type":["number","null"]},"apyReward":{"type":["number","null"]},"apyPct7D":{"type":["number","null"]},"stablecoin":{"type":"boolean"},"ilRisk":{"type":"string"},"exposure":{"type":"string"}}},"PriceList":{"type":"object","properties":{"asOf":{"type":"string","format":"date-time"},"coins":{"type":"array","items":{"type":"object","properties":{"coin":{"type":"string"},"price":{"type":"number"},"symbol":{"type":["string","null"]},"decimals":{"type":["integer","null"]},"timestamp":{"type":["integer","null"]},"confidence":{"type":["number","null"]}}}}}},"ChainList":{"type":"object","properties":{"asOf":{"type":"string","format":"date-time"},"count":{"type":"integer"},"chains":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"tvl":{"type":"number"},"tokenSymbol":{"type":["string","null"]},"chainId":{"type":["integer","null"]}}}}}}}}}