{"openapi":"3.1.0","info":{"title":"KushBitx AgentProof API","version":"1.0.0","description":"Pay-per-call crypto security and payment verification for people, applications and AI agents.","contact":{"name":"KushBitx","email":"admin@kushbitx.com"}},"servers":[{"url":"https://www.kushbitx.com"}],"paths":{"/api/token-preview":{"post":{"operationId":"token_preview","summary":"Free Base token market preview","description":"Market identity and trading-pair data. No wallet, payment or API key required. Does not include security checks or a risk verdict.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string","enum":["base"],"description":"Blockchain network."},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Base token contract address."}},"required":["chain","address"],"additionalProperties":false},"example":{"chain":"base","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}}},"responses":{"200":{"description":"Market preview with token, market and paidReportAdds fields"},"400":{"description":"Invalid Base token address"},"404":{"description":"No Base trading pair found"},"502":{"description":"Market data provider unavailable"}}}},"/api/token-risk":{"post":{"operationId":"token_risk","summary":"Token Risk","description":"Screen a Base token for sellability, taxes, privileged controls, holder concentration and market risk. Payment: 0.25 USDC per successful call via x402.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string","enum":["base"],"description":"Blockchain network."},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Base token contract address."}},"required":["chain","address"],"additionalProperties":false},"example":{"chain":"base","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}}}},"responses":{"200":{"description":"Paid result","content":{"application/json":{"example":{"verdict":{"level":"low","score":0,"confidence":"high"},"security":{},"controls":{},"market":{}}}}},"400":{"description":"Invalid request"},"402":{"description":"PAYMENT-REQUIRED header contains the x402 payment challenge"},"502":{"description":"Upstream provider or settlement unavailable"}}}},"/api/transaction-preflight":{"post":{"operationId":"transaction_preflight","summary":"Transaction Preflight","description":"Simulate an unsigned Base transaction and detect failed execution, dangerous approvals and destination risk signals. Payment: 0.05 USDC per successful call via x402.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string","enum":["base"]},"from":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional sender used for simulation."},"to":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Transaction destination."},"valueWei":{"type":"string","pattern":"^[0-9]+$","description":"Native ETH value in wei."},"data":{"type":"string","pattern":"^0x([a-fA-F0-9]{2})*$","description":"Unsigned calldata."}},"required":["chain","to"],"additionalProperties":false},"example":{"chain":"base","from":"0x0d68028d06af13379C872FEE032568B4Be712f22","to":"0x0d68028d06af13379C872FEE032568B4Be712f22","valueWei":"0","data":"0x"}}}},"responses":{"200":{"description":"Paid result","content":{"application/json":{"example":{"verdict":{"decision":"ALLOW","score":0,"confidence":"high"},"destination":{},"simulation":{},"findings":[]}}}},"400":{"description":"Invalid request"},"402":{"description":"PAYMENT-REQUIRED header contains the x402 payment challenge"},"502":{"description":"Upstream provider or settlement unavailable"}}}},"/api/verify-payment":{"post":{"operationId":"verify_payment","summary":"Payment Proof","description":"Verify an onchain Base USDC payment, its recipient, amount, status and confirmations. Payment: 0.01 USDC per successful call via x402.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"chain":{"type":"string","enum":["base"]},"txHash":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"expectedTo":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"expectedFrom":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"expectedAmount":{"type":"string","pattern":"^[0-9]+(\\.[0-9]{1,6})?$","description":"Expected USDC amount."}},"required":["chain","txHash"],"additionalProperties":false},"example":{"chain":"base","txHash":"0x0000000000000000000000000000000000000000000000000000000000000000","expectedTo":"0x0d68028d06af13379C872FEE032568B4Be712f22","expectedAmount":"1.00"}}}},"responses":{"200":{"description":"Paid result","content":{"application/json":{"example":{"verdict":{"decision":"VERIFIED","verified":true},"confirmations":1,"transfers":[]}}}},"400":{"description":"Invalid request"},"402":{"description":"PAYMENT-REQUIRED header contains the x402 payment challenge"},"502":{"description":"Upstream provider or settlement unavailable"}}}}}}