QProof / developer access
Read a report.
Keep its evidence.
Public stored reports need no API key or wallet connection. Responses include the canonical verdict, six key numbers, original evidence age and full report.
MCP
Connect to https://qhooks.com/mcp and call qproof_check.
{
"name": "qproof_check",
"arguments": {
"chain": "4663",
"token": "0x20429af7ca3b0ce4d99edbaa0693f26c5df05195",
"request": false
}
}request:false is a stored-only read. Omit it to request a scheduled refresh when a report is missing or stale. request:true explicitly requests the existing scheduled lane. Admission and scan budgets still apply; queued is shown only when confirmed.
HTTP API
curl 'https://qhooks.com/api/v1/agent/qproof-check?chain=4663&token=0x20429af7ca3b0ce4d99edbaa0693f26c5df05195&request=false'Store the report ID and freshness.checkedAt with your decision. Never treat a missing number as zero or an incomplete report as clear.
- danger
- The report contains a high-risk finding.
- watch
- A completed check found something to review.
- clear
- The required evidence completed without a flagged finding.
- incomplete
- Not fully checked. Some required evidence is missing.
Stored report · $0.02
Stored QProof report. No fresh scan. This paid endpoint returns stored evidence and does not start a fresh scan. qproof_check and the public stored-report API remain free.
curl -i 'https://qhooks.com/api/x402/v1/qproof?chain=4663&address=0x20429af7ca3b0ce4d99edbaa0693f26c5df05195'Fresh scan · $0.25
Fresh QProof scan, run on request. A fresh scan starts after the signing wallet explicitly authorizes its x402 payment and read-only preflight succeeds. Settlement occurs only after required checks complete. Read current price and accepted rails from the response.
{
"name": "qproof_scan",
"arguments": {
"chain": "4663",
"token": "0x20429af7ca3b0ce4d99edbaa0693f26c5df05195"
}
}The first call returns payment terms. Choose an accepted rail and have the signing wallet authorize it, then submit that signed payment with payment and paymentVersion:2. If a required check remains incomplete, the endpoint submits no payment and returns HTTP 503 with partial evidence when available, charged:false, authorizationSubmitted:false and settlementAttempted:false. Honor Retry-After and reuse the same valid authorization for status/recovery.
curl -i 'https://qhooks.com/api/x402/v1/qproof/scan?chain=4663&address=0x20429af7ca3b0ce4d99edbaa0693f26c5df05195'Payment and signing
Pay in USDG on Robinhood Chain or USDC on Base. The price is the same on either rail; read the response before authorizing payment.
Discovery: /api/x402/discovery/resources. Prepared for the signing wallet: the agent’s own wallet or yours. No custody; QHooks never holds wallet keys.
Limits and freshness
Cached agent reads have no hourly or daily quota. Abuse protection permits 60 reads per minute per IP; fresh upstream paths have a separate 20-per-minute guard. A limited response includes Retry-After. A scheduled refresh is separate from a paid on-demand scan.