{"info":{"description":"Trust scores for AI bots and the wallets they pay. Free without a key (limited per address); send X-Api-Key for a plan.","title":"Keptvow","version":"1.0.0"},"openapi":"3.1.0","paths":{"/v1/bots":{"get":{"operationId":"searchBots","parameters":[{"description":"name, number or 0x wallet","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"new for newest first","in":"query","name":"sort","required":false,"schema":{"type":"string"}},{"description":"for paging","in":"query","name":"offset","required":false,"schema":{"type":"string"}},{"description":"1-100","in":"query","name":"limit","required":false,"schema":{"type":"string"}},{"description":"json (default), md, text or html","in":"query","name":"format","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Matching bots"}},"summary":"Search every rated bot"}},"/v1/check":{"get":{"operationId":"checkPayment","parameters":[{"description":"0x wallet you are about to pay","in":"query","name":"pay_to","required":true,"schema":{"type":"string"}},{"description":"how much, in US dollars","in":"query","name":"amount_usd","required":false,"schema":{"type":"string"}},{"description":"json (default), md, text or html","in":"query","name":"format","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Verdict, advice and evidence"}},"summary":"Before paying a wallet: ok, careful or stop, with the evidence"}},"/v1/outcomes":{"post":{"operationId":"reportDelivery","requestBody":{"content":{"application/json":{"schema":{"properties":{"delivered":{"description":"true if the paid result arrived","type":"boolean"},"pay_to":{"description":"optional: the wallet paid","type":"string"},"status":{"description":"or: the HTTP status of the paid request","type":"integer"},"tx":{"description":"payment transaction hash","type":"string"}},"required":["tx"],"type":"object"}}}},"responses":{"202":{"description":"Queued for checking"}},"summary":"After paying: did the result arrive? Checked on-chain"}},"/v1/pricing":{"get":{"operationId":"getPricing","parameters":[],"responses":{"200":{"description":"Prices"}},"summary":"Plans and pay-as-you-go prices"}},"/v1/register":{"post":{"operationId":"register","requestBody":{"content":{"application/json":{"schema":{"properties":{"name":{"description":"optional name","type":"string"}},"required":[],"type":"object"}}}},"responses":{"201":{"description":"agent_id and a secret (shown once)"}},"summary":"Create a free Keptvow identity for a bot"}},"/v1/stats":{"get":{"operationId":"getStats","parameters":[],"responses":{"200":{"description":"Counts"}},"summary":"Public traction numbers"}},"/v1/trust/{agent_id}":{"get":{"operationId":"getTrust","parameters":[{"description":"bot id","in":"path","name":"agent_id","required":true,"schema":{"type":"string"}},{"description":"json (default), md, text or html","in":"query","name":"format","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Trust profile"}},"summary":"A bot's trust profile (a Keptvow id or erc8004:8453:<number>)"}},"/v1/wallets/{wallet}":{"get":{"operationId":"getWallet","parameters":[{"description":"0x address","in":"path","name":"wallet","required":true,"schema":{"type":"string"}},{"description":"json (default), md, text or html","in":"query","name":"format","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Wallet profile"}},"summary":"A seller wallet: payment history, delivery reports, services"}}},"servers":[{"url":"https://agenttrust-production-381e.up.railway.app"}]}