# payflow-datafeed

> Market & on-chain data proxy: DeFi yield pools, per-chain TVL and live token prices (DeFiLlama). Pay-per-call via x402. Free probe at /v1/sample (no payment).

## Endpoints
- GET https://data.payflowagent.net/v1/sample  Free.
- GET https://data.payflowagent.net/v1/yields  Paid ($0.01 USDC, x402). yields.
- GET https://data.payflowagent.net/v1/yield-opportunities  Paid ($0.02 USDC, x402). yield-opportunities.
- GET https://data.payflowagent.net/v1/prices  Paid ($0.005 USDC, x402). prices.
- GET https://data.payflowagent.net/v1/chains  Paid ($0.01 USDC, x402). chains.

## How to pay (x402)
1. Call a paid endpoint. You receive HTTP 402 with payment requirements (PAYMENT-REQUIRED header).
2. Pay in USDC with any x402 client (e.g. x402-fetch / x402 SDK) and retry the request.
3. Network: eip155:8453 · Asset: USDC · Scheme: exact · Pay to: 0x617122b245C776A6B83A1f2821617819E2d38F6b

## Machine-readable
- OpenAPI: https://data.payflowagent.net/openapi.json
- x402 manifest: https://data.payflowagent.net/.well-known/x402.json

## What you get
- Ranked DeFi yield pools (APY, TVL, base/reward APY, IL risk) with filters
- Agent-ready yield opportunities with risk score (0-100) and explainable reasons (/v1/yield-opportunities)
- Per-chain TVL ranking
- Current USD prices for arbitrary tokens

## Coin ids (for /v1/prices)
- Format: "{chain}:{address}" (e.g. "ethereum:0xA0b8...") or "coingecko:{id}" (e.g. "coingecko:ethereum").
- Multiple coins: comma-separated.

## Notes
- Try the free /v1/sample endpoint first — includes raw top pools plus a 3-item opportunity preview (score + reasons).
- Full ranked opportunities: GET /v1/yield-opportunities (paid via x402).
- Data is cached and refreshed in the background — designed for agents that poll frequently.