{"openapi":"3.1.0","info":{"title":"WalletAWARE API","version":"0.1.0-free-beta","description":"Conservative Base wallet sell-intent signals with calibrated probability, evidence, freshness, coverage, and explicit limitations."},"servers":[{"url":"https://api-payment-staging.up.railway.app"}],"tags":[{"name":"Discovery"},{"name":"Prediction"},{"name":"Operations"}],"paths":{"/v1/wallet/intent":{"post":{"operationId":"predictWalletIntent","tags":["Prediction"],"summary":"Predict near-term Base wallet intent from recent observable activity","description":"Returns a conservative signal. Low evidence intentionally produces indeterminate.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentRequest"}}}},"responses":{"200":{"description":"Versioned prediction envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentResponse"}}}},"400":{"description":"Invalid request"},"429":{"description":"Per-client rate limit"},"502":{"description":"Base RPC failure"},"503":{"description":"Concurrent capacity limit"}}}},"/v1/wallet/intent/preview":{"get":{"operationId":"getWalletAwarePreview","tags":["Discovery"],"summary":"Inspect the product without making a live prediction","responses":{"200":{"description":"Static product preview"}}}},"/schema":{"get":{"operationId":"getWalletAwareSchema","tags":["Discovery"],"summary":"Read compact endpoint and coverage documentation","responses":{"200":{"description":"Endpoint schema"}}}},"/metrics":{"get":{"operationId":"getBetaMetrics","tags":["Operations"],"summary":"Read privacy-preserving aggregate beta metrics","responses":{"200":{"description":"Process-local aggregate metrics"}}}},"/health":{"get":{"operationId":"getHealth","tags":["Operations"],"summary":"Check service health and payment mode","responses":{"200":{"description":"Service is ready"}}}}},"components":{"schemas":{"IntentRequest":{"type":"object","additionalProperties":false,"required":["address"],"properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"horizonHours":{"type":"integer","minimum":1,"maximum":72,"default":24},"lookbackMinutes":{"type":"integer","minimum":5,"maximum":1440,"default":360}}},"IntentResponse":{"type":"object","required":["schema","product","request","result","freshness","coverage","pricing"],"properties":{"schema":{"const":"wallet-aware/intent-response/v1"},"product":{"type":"object"},"request":{"type":"object"},"result":{"$ref":"#/components/schemas/Prediction"},"context":{"type":"object"},"freshness":{"type":"object"},"coverage":{"type":"object"},"pricing":{"type":"object"}}},"Prediction":{"type":"object","required":["intent","confidence","model","limitations"],"properties":{"intent":{"enum":["preparing_to_sell","bridging","adding_liquidity","removing_liquidity","indeterminate"]},"confidence":{"type":"number","minimum":0,"maximum":1},"recommendation":{"type":"string"},"evidence":{"type":"array","items":{"type":"object"}},"contradictions":{"type":"array","items":{"type":"object"}},"candidates":{"type":"array","items":{"type":"object"}},"model":{"type":"object"},"limitations":{"type":"array","items":{"type":"string"}}}}}}}