{"openapi":"3.1.0","info":{"title":"PayFlowAgent API","version":"1.0.0","description":"Decision-ready risk & momentum scores for nad.fun tokens on Monad. Free probe at /v1/lite; full reports are pay-per-call in USDC via the x402 protocol (HTTP 402).","x-pricing":{"decide":0.1,"summary":0.03,"screen":0.05,"currency":"USDC"}},"servers":[{"url":"https://payflowagent.net"}],"paths":{"/v1/lite":{"get":{"operationId":"getLite","summary":"Free score (no payment)","description":"Free, rate-limited: score (0-100), riskLevel and action for a nad.fun token.","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x9cF1538f92341A311a922D411DE8C471DCEA7777","description":"nad.fun token address on Monad (0x..., 42 chars)"}}],"responses":{"200":{"description":"Lite score","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiteResult"},"example":{"token":"0x9cF1538f92341A311a922D411DE8C471DCEA7777","score":81,"riskLevel":"SAFE","action":"BUY_OK","asOf":"2026-06-27T18:00:00.000Z"}}}},"400":{"description":"Invalid token address"},"429":{"description":"Rate limit exceeded"}}}},"/v1/decide":{"get":{"operationId":"getDecide","summary":"Full risk/momentum report (paid via x402)","description":"Paid (x402, USDC). Returns 402 Payment Required with payment requirements; pay with an x402 client and retry. Full report: score, riskLevel, action, explainable factors, graduation and momentum.","x-402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetSymbol":"USDC","scheme":"exact","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","payTo":"0x617122b245C776A6B83A1f2821617819E2d38F6b"},"parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x9cF1538f92341A311a922D411DE8C471DCEA7777","description":"nad.fun token address on Monad (0x..., 42 chars)"}}],"responses":{"200":{"description":"Full decision report","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecideResult"}}}},"400":{"description":"Invalid token address"},"402":{"description":"Payment Required (x402). See PAYMENT-REQUIRED header."}}}},"/v1/token/{address}/summary":{"get":{"operationId":"getSummary","summary":"Cheap entry: graduation + momentum (paid via x402)","description":"Paid (x402, USDC). Graduation progress + momentum summary for a nad.fun token.","x-402":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetSymbol":"USDC","scheme":"exact","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","payTo":"0x617122b245C776A6B83A1f2821617819E2d38F6b"},"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","example":"0x9cF1538f92341A311a922D411DE8C471DCEA7777","description":"nad.fun token address on Monad (0x..., 42 chars)"}}],"responses":{"200":{"description":"Summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SummaryResult"}}}},"400":{"description":"Invalid token address"},"402":{"description":"Payment Required (x402)."}}}},"/v1/screen":{"get":{"operationId":"getScreen","summary":"Ranked list of pre-scored fresh tokens (paid via x402)","description":"Paid (x402, USDC). Returns a ranked list of pre-scored, fresh nad.fun tokens (score, riskLevel, action, graduation, holders). Built by a background refresh and served from cache — designed for screeners/agents that poll frequently.","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":25,"default":10}},{"name":"minScore","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":100,"default":0}}],"responses":{"200":{"description":"Ranked token list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScreenResult"}}}},"402":{"description":"Payment Required (x402)."}}}}},"components":{"schemas":{"LiteResult":{"type":"object","properties":{"token":{"type":"string"},"score":{"type":"integer","minimum":0,"maximum":100},"riskLevel":{"type":"string","enum":["SAFE","LOW","MEDIUM","HIGH","CRITICAL"]},"action":{"type":"string"},"asOf":{"type":"string","format":"date-time"}}},"SummaryResult":{"type":"object","properties":{"token":{"type":"string"},"graduation":{"type":"object","properties":{"progressPct":{"type":"number"},"isGraduated":{"type":"boolean"}}},"momentum":{"type":"object"},"asOf":{"type":"string","format":"date-time"}}},"DecideResult":{"type":"object","properties":{"token":{"type":"string"},"score":{"type":"integer"},"riskLevel":{"type":"string"},"action":{"type":"string"},"graduation":{"type":"object"},"momentum":{"type":"object"},"factors":{"type":"array","items":{"type":"object"}},"asOf":{"type":"string","format":"date-time"}}},"ScreenResult":{"type":"object","properties":{"asOf":{"type":"string","format":"date-time"},"count":{"type":"integer"},"network":{"type":"string"},"tokens":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string"},"symbol":{"type":"string"},"name":{"type":"string"},"score":{"type":"integer","minimum":0,"maximum":100},"riskLevel":{"type":"string"},"action":{"type":"string"},"graduationPct":{"type":"number"},"isGraduated":{"type":"boolean"},"holderCount":{"type":["integer","null"]},"priceUsd":{"type":["string","null"]}}}}}}}}}