# yieldprobe

> Real-time DeFi intelligence API for AI agents. Pay per call in USDC over x402 (HTTP 402), or use the hashcash free tier.

## Endpoints
- GET https://yieldprobe.com/v1/yields — Top pools by APY, filterable ($0.002)
- GET https://yieldprobe.com/v1/yields/movers — Largest APY moves 1d/7d ($0.002)
- GET https://yieldprobe.com/v1/stables/peg — Stablecoin peg + supply monitor ($0.002)
- GET https://yieldprobe.com/v1/token/{chainId}/{address}/security — Token risk score ($0.003)

## How to pay
- Protocol: x402 v2, network eip155:8453, asset USDC, scheme exact.
- Send the request; on 402 read PAYMENT-REQUIRED, sign, retry with PAYMENT-SIGNATURE. SDK: @x402/fetch.
- Include extension payment-identifier with a unique id; retrying with the same id after a network error is free (idempotent).
- Every paid response carries an EIP-712 receipt (offer-receipt extension) and a signed data attestation in meta.

## Free tier
- https://yieldprobe.com/v1/pow/info

## Machine-readable
- https://yieldprobe.com/.well-known/agent-card.json
- https://yieldprobe.com/openapi.json