# PayFlowAgent

> Token intelligence API for nad.fun tokens on Monad (mainnet). Returns decision-ready
> risk & momentum scores. Free probe available; full reports are pay-per-call in USDC
> via the x402 protocol (HTTP 402, network eip155:8453).

## What you get
- score (0-100), riskLevel, action
- graduation progress (bonding-curve %), 5-minute momentum
- explainable factors (full report only)

## Endpoints
- GET https://payflowagent.net/v1/lite?token=0x...            Free, rate-limited (score, riskLevel, action).
- GET https://payflowagent.net/v1/decide?token=0x...          Paid ($0.10 USDC, x402). Full report.
- GET https://payflowagent.net/v1/token/{address}/summary     Paid ($0.03 USDC, x402). Graduation + momentum.
- GET https://payflowagent.net/v1/screen?limit=10&minScore=60 Paid ($0.05 USDC, x402). Ranked list of pre-scored fresh tokens (poll-friendly).

## 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://payflowagent.net/openapi.json
- x402 manifest: https://payflowagent.net/.well-known/x402.json

## Notes
- Try the free /v1/lite endpoint first to evaluate quality before paying.
- Token addresses are nad.fun tokens on Monad (0x..., 42 hex chars).