{"openapi":"3.1.0","info":{"title":"Tollex","version":"0.2.0","description":"Paid capabilities for autonomous agents on Robinhood Chain. Plan with resolve, pay per call with x402 in USDG on Robinhood Chain or USDC on Base, and get a signed receipt with every result.","x-guidance":"Plan for free, then pay per call with x402. 1) POST /v1/resolve with {\"need\": \"...\"} (free) returns the capability that fits, its input and price. 2) POST /tools/{toolId} with the JSON input: the first response is 402 with x402 v2 terms, one option per rail (USDC on Base eip155:8453 or USDG on Robinhood Chain eip155:4663, same price). 3) Pay with any x402 v2 client (exact, EIP-3009) within your spending ceiling; the result arrives with a signed EIP-712 receipt in the PAYMENT-RESPONSE header. Cheapest first paid call: GET /v1/agent-check. If a response is lost, check GET /tollex/operations/{operationId} instead of paying again. No account or API key."},"servers":[{"url":"https://api.tollex.org"}],"tags":[{"name":"planning","description":"Free: catalog, health, resolve, find, quote"},{"name":"settlement","description":"Free: operation status, receipts, receipt keys"}],"paths":{"/v1/catalog":{"get":{"operationId":"catalog","tags":["planning"],"summary":"List every capability with schemas, prices and receipt support. Free.","responses":{"200":{"description":"Catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}}},"security":[]}},"/v1/health":{"get":{"operationId":"health","tags":["planning"],"summary":"Provider health as last observed. Free.","responses":{"200":{"description":"Health","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}}},"security":[]}},"/v1/resolve":{"post":{"operationId":"resolve","tags":["planning"],"summary":"Plan a purchase for a need under constraints. Returns eligible capabilities, rejection reasons and the selected route. Never spends.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentRequest"},"example":{"need":"ETH-USD spot price","input":{"pair":"ETH-USD"},"constraints":{"maxCost":"5000","receiptRequired":true}}}}},"responses":{"200":{"description":"Resolution plan (selected is null when nothing is eligible; see rejectedBy and diagnosis)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveResponse"}}}},"400":{"description":"Invalid intent (unknown field, bad constraint)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[]}},"/v1/find":{"post":{"operationId":"find","tags":["planning"],"summary":"Deterministic capability search with documented scoring. Free.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"need":{"type":"string","maxLength":500},"constraints":{"type":"object"}},"required":["need"]}}}},"responses":{"200":{"description":"Ranked candidates","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[]}},"/v1/quote":{"post":{"operationId":"quote","tags":["planning"],"summary":"Hash-bound, expiring quote for a capability and input. Free.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"toolId":{"type":"string"},"input":{"type":"object"}},"required":["toolId","input"]}}}},"responses":{"200":{"description":"Quote","content":{"application/json":{"schema":{"type":"object","required":["quoteId","quoteHash","maxAmount","expiresAt"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Unknown capability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[]}},"/tollex/operations/{operationId}":{"get":{"operationId":"operationStatus","tags":["settlement"],"summary":"Durable payment and settlement status of an operation. Use this instead of treating a timeout as failure.","parameters":[{"name":"operationId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":128}}],"responses":{"200":{"description":"Operation status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationStatus"}}}},"404":{"description":"Unknown operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[]}},"/tollex/receipts/{receiptId}":{"get":{"operationId":"receipt","tags":["settlement"],"summary":"Signed execution receipt (EIP-712).","parameters":[{"name":"receiptId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":128}}],"responses":{"200":{"description":"Receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignedReceipt"}}}},"404":{"description":"Unknown receipt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[]}},"/.well-known/tollex-receipt-keys":{"get":{"operationId":"receiptKeys","tags":["settlement"],"summary":"Receipt signing keys with rotation and revocation status.","responses":{"200":{"description":"Key set","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceiptKeys"}}}}},"security":[]}},"/v1/providers/validate":{"post":{"operationId":"validateProvider","tags":["providers"],"summary":"Inspect and validate a provider source (OpenAPI, manifest, MCP, A2A, llms.txt, x402) without importing it.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"document":{"type":"string"},"kind":{"type":"string"},"defaultPrice":{"type":"string"}}}}}},"responses":{"200":{"description":"Report with structured issue codes","content":{"application/json":{"schema":{"type":"object","required":["valid","issues"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"413":{"description":"Document too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too many concurrent validations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[]}},"/tools/chain_get_block":{"post":{"operationId":"tool_chain_get_block","summary":"Get block on Robinhood Chain","description":"Block header by number or tag (latest | safe | finalized) on Robinhood Chain, including Ethereum parent-chain L1 block number. Use when an agent needs the current Robinhood Chain head, or a block's time and parent-chain anchor.","tags":["chain"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"block":{"type":"string","pattern":"^(latest|safe|finalized|[0-9]{1,15})$"}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"number":{"type":"string"},"hash":{"type":"string"},"parentHash":{"type":"string"},"timestamp":{"type":"string","description":"ISO 8601"},"transactions":{"type":"integer","description":"transaction count"},"gasUsed":{"type":"string"},"baseFeePerGas":{"type":["string","null"]},"l1BlockNumber":{"type":["string","null"],"description":"Ethereum parent-chain block number"}},"required":["number","hash","parentHash","timestamp","transactions","gasUsed","baseFeePerGas","l1BlockNumber"],"example":{"number":"83335219","hash":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036","parentHash":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036","timestamp":"2026-10-08T13:04:26.000Z","transactions":4,"gasUsed":"412876","baseFeePerGas":"10000000","l1BlockNumber":"23541870"}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/chain_get_transaction":{"post":{"operationId":"tool_chain_get_transaction","summary":"Get transaction on Robinhood Chain","description":"Transaction by hash: sender, recipient, value, nonce, type, calldata size and inclusion block.","tags":["chain"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},"required":["hash"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"found":{"type":"boolean"},"from":{"type":"string"},"to":{"type":["string","null"]},"value":{"type":"string","description":"wei"},"nonce":{"type":"integer"},"type":{"type":"string"},"inputBytes":{"type":"integer"},"selector":{"type":"string"},"blockNumber":{"type":["string","null"]},"blockHash":{"type":["string","null"]}},"required":["found"],"example":{"found":true,"from":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","to":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","value":"0","nonce":12,"type":"eip1559","inputBytes":228,"selector":"0xe3ee160e","blockNumber":"83335219","blockHash":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036"},"description":"When found is false, only { found: false } is returned."},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["chain_receipt"]}},"/tools/chain_get_receipt":{"post":{"operationId":"tool_chain_get_receipt","summary":"Get receipt on Robinhood Chain","description":"Transaction receipt with observed settlement assurance (l2_included → l2_confirmed → parent_safe → parent_finalized), canonicality re-check and confirmations.","tags":["chain"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"confirmations":{"type":"integer","minimum":1,"maximum":1000}},"required":["hash"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"found":{"type":"boolean"},"status":{"type":["string","null"],"description":"success or reverted"},"blockNumber":{"type":["string","null"]},"blockHash":{"type":["string","null"]},"gasUsed":{"type":["string","null"]},"effectiveGasPrice":{"type":["string","null"]},"logs":{"type":"integer","description":"log count"},"assurance":{"type":["string","null"],"description":"settlement assurance level, e.g. l2_included, parent_finalized"},"canonical":{"type":["boolean","null"]},"confirmations":{"type":["integer","null"]}},"required":["found"],"example":{"found":true,"status":"success","blockNumber":"83335219","blockHash":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036","gasUsed":"61021","effectiveGasPrice":"10000000","logs":2,"assurance":"parent_finalized","canonical":true,"confirmations":1200}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["chain_receipt"]}},"/tools/chain_get_logs":{"post":{"operationId":"tool_chain_get_logs","summary":"Get logs on Robinhood Chain","description":"Event logs for a contract over a bounded block range (max range enforced), optionally filtered by topic0. Use when an agent needs verifiable contract event history on Robinhood Chain (transfers, mints, swaps) for a known block range.","tags":["chain"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"fromBlock":{"type":"integer","minimum":0},"toBlock":{"type":"integer","minimum":0},"topic0":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},"required":["address","fromBlock","toBlock"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"count":{"type":"integer"},"truncated":{"type":"boolean","description":"true when more than 500 logs matched"},"logs":{"type":"array","items":{"type":"object","properties":{"blockNumber":{"type":"string"},"tx":{"type":"string"},"logIndex":{"type":"integer"},"topics":{"type":"array","items":{"type":"string"}},"data":{"type":"string"}},"required":["blockNumber","tx","logIndex","topics","data"],"example":{"blockNumber":"83335219","tx":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036","logIndex":0,"topics":["0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036"],"data":"0x"}}}},"required":["count","truncated","logs"],"example":{"count":1,"truncated":false,"logs":[{"blockNumber":"83335219","tx":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036","logIndex":0,"topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"],"data":"0x0000000000000000000000000000000000000000000000000000000000001edc"}]}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/chain_contract_read":{"post":{"operationId":"tool_chain_contract_read","summary":"Contract read on Robinhood Chain","description":"Read-only call of one view/pure function given its human-readable ABI signature, at a pinned block. Use when an agent needs one view-function value from a Robinhood Chain contract without running a node.","tags":["chain"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"signature":{"type":"string","maxLength":300,"pattern":"^function [A-Za-z0-9_]+\\(.*\\) (external |public )?(view|pure) returns \\(.*\\)$","examples":["function balanceOf(address) view returns (uint256)"]},"args":{"type":"array","maxItems":10}},"required":["address","signature"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"result":{"description":"decoded return value(s) of the function; bigints as decimal strings"}},"required":["result"],"example":{"result":"1000000000"}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/chain_simulate":{"post":{"operationId":"tool_chain_simulate","summary":"Simulate call on Robinhood Chain","description":"Simulate a call against current state (eth_call). Never broadcasts. Returns return data or the revert reason/selector. Use before signing or sending a Robinhood Chain transaction, to see whether it would revert (pre-flight, honeypot check).","tags":["chain"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"to":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"data":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","maxLength":200000},"value":{"type":"string","pattern":"^[0-9]{1,78}$"}},"required":["to","data"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"ok":{"type":"boolean","description":"false when the call reverts"},"returnData":{"type":"string","description":"present when ok"},"revertSelector":{"type":["string","null"],"description":"4-byte revert selector when not ok"},"error":{"type":"string","description":"first line of the revert reason when not ok"}},"required":["ok"],"example":{"ok":true,"returnData":"0x000000000000000000000000000000000000000000000000000000003b9aca00"}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/chain_get_code":{"post":{"operationId":"tool_chain_get_code","summary":"Get code on Robinhood Chain","description":"Runtime bytecode hash and size for an address; detects EIP-7702 delegated EOAs (0xef0100 prefix) and ERC-1967 proxies.","tags":["chain"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["address"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"address":{"type":"string"},"size":{"type":"integer","description":"bytes"},"codeHash":{"type":["string","null"]},"isContract":{"type":"boolean"},"eip7702Delegate":{"type":["string","null"]},"erc1967Implementation":{"type":["string","null"]}},"required":["address","size","codeHash","isContract","eip7702Delegate","erc1967Implementation"],"example":{"address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","size":1650,"codeHash":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036","isContract":true,"eip7702Delegate":null,"erc1967Implementation":null}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/chain_estimate_gas":{"post":{"operationId":"tool_chain_estimate_gas","summary":"Estimate gas on Robinhood Chain","description":"Gas estimate plus current base fee and priority fee, with the implied maximum cost in wei. Never broadcasts.","tags":["chain"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"to":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"data":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","maxLength":200000},"value":{"type":"string","pattern":"^[0-9]{1,78}$"}},"required":["to"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"gas":{"type":"string"},"baseFeePerGas":{"type":"string","description":"wei"},"maxPriorityFeePerGas":{"type":"string","description":"wei"},"estimatedCostWei":{"type":"string"}},"required":["gas","baseFeePerGas","maxPriorityFeePerGas","estimatedCostWei"],"example":{"gas":"61021","baseFeePerGas":"10000000","maxPriorityFeePerGas":"0","estimatedCostWei":"610210000000"}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/wallet_native_balance":{"post":{"operationId":"tool_wallet_native_balance","summary":"Native ETH balance on Robinhood Chain","description":"ETH (gas asset) balance and transaction count of an address on Robinhood Chain.","tags":["wallet"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["address"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"address":{"type":"string"},"wei":{"type":"string"},"nonce":{"type":"integer"}},"required":["address","wei","nonce"],"example":{"address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","wei":"7897952253800000","nonce":1}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/wallet_token_balance":{"post":{"operationId":"tool_wallet_token_balance","summary":"Token balance on Robinhood Chain","description":"ERC-20 balance (atomic units + decimals) of an address; defaults to USDG. Use when an agent needs a wallet's ERC-20 balance on Robinhood Chain, for example before paying or trading.","tags":["wallet"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["address"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"address":{"type":"string"},"token":{"type":"string"},"balance":{"type":"string","description":"atomic units"},"decimals":{"type":["integer","null"]}},"required":["address","token","balance","decimals"],"example":{"address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","token":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","balance":"14051","decimals":6}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/wallet_allowance":{"post":{"operationId":"tool_wallet_allowance","summary":"Allowance on Robinhood Chain","description":"ERC-20 allowance from owner to spender (default spender: canonical Permit2). Permit2-based x402 payments need this allowance in place.","tags":["wallet"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"spender":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["owner"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"owner":{"type":"string"},"token":{"type":"string"},"spender":{"type":"string"},"allowance":{"type":"string"},"unlimited":{"type":"boolean"}},"required":["owner","token","spender","allowance","unlimited"],"example":{"owner":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","token":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","spender":"0x000000000022D473030F116dDEE9F6B43aC78BA3","allowance":"0","unlimited":false}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/wallet_authorization_state":{"post":{"operationId":"tool_wallet_authorization_state","summary":"EIP-3009 authorization state on Robinhood Chain","description":"Whether an EIP-3009 authorization nonce has been used (authorizationState). On USDG a replayed authorization does not revert, so use this check rather than a simulation to detect consumed authorizations.","tags":["wallet"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"authorizer":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"nonce":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["authorizer","nonce"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"token":{"type":"string"},"authorizer":{"type":"string"},"nonce":{"type":"string"},"used":{"type":"boolean"}},"required":["token","authorizer","nonce","used"],"example":{"token":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","authorizer":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","nonce":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036","used":false}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/wallet_activity":{"post":{"operationId":"tool_wallet_activity","summary":"Token activity on Robinhood Chain","description":"Recent ERC-20 Transfer events into and out of an address (default token USDG) over a bounded block window.","tags":["wallet"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"blocks":{"type":"integer","minimum":1,"maximum":50000}},"required":["address"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"address":{"type":"string"},"token":{"type":"string"},"fromBlock":{"type":"string"},"toBlock":{"type":"string"},"transfers":{"type":"array","items":{"type":"object","properties":{"direction":{"type":"string","description":"in or out"},"from":{"type":"string"},"to":{"type":"string"},"value":{"type":"string"},"blockNumber":{"type":"string"},"tx":{"type":"string"}},"required":["direction","from","to","value","blockNumber","tx"],"example":{"direction":"in","from":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","to":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","value":"7900","blockNumber":"83335219","tx":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036"}}}},"required":["address","token","fromBlock","toBlock","transfers"],"example":{"address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","token":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","fromBlock":"83300000","toBlock":"83335219","transfers":[{"direction":"in","from":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","to":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","value":"7900","blockNumber":"83335219","tx":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036"}]}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/usdg_metadata":{"post":{"operationId":"tool_usdg_metadata","summary":"USDG metadata on Robinhood Chain","description":"USDG (Paxos Global Dollar) on Robinhood Chain: address, name, symbol, decimals, total supply and current ERC-1967 implementation.","tags":["usdg"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"network":{"type":"string"},"address":{"type":"string"},"name":{"type":["string","null"]},"symbol":{"type":["string","null"]},"decimals":{"type":["integer","null"]},"totalSupply":{"type":["string","null"]},"implementation":{"type":["string","null"]}},"required":["network","address","name","symbol","decimals","totalSupply","implementation"],"example":{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","name":"Global Dollar","symbol":"USDG","decimals":6,"totalSupply":"125000000000000","implementation":null}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/usdg_domain":{"post":{"operationId":"tool_usdg_domain","summary":"USDG EIP-712 domain on Robinhood Chain","description":"USDG EIP-712 signing domain and on-chain DOMAIN_SEPARATOR, with a byte-for-byte reconstruction check.","tags":["usdg"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"domain":{"type":"object","description":"name, version, chainId, verifyingContract"},"onchainDomainSeparator":{"type":"string"},"reconstructed":{"type":"string"},"matches":{"type":"boolean"}},"required":["domain","onchainDomainSeparator","reconstructed","matches"],"example":{"domain":{"name":"Global Dollar","version":"1","chainId":4663,"verifyingContract":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168"},"onchainDomainSeparator":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036","reconstructed":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036","matches":true}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/usdg_capabilities":{"post":{"operationId":"tool_usdg_capabilities","summary":"USDG capability probe on Robinhood Chain","description":"Live, facet-aware verification of USDG EIP-3009/EIP-2612/EIP-712 capability and x402 contract bytecode on Robinhood Chain (read-only).","tags":["usdg"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"ok":{"type":"boolean"},"blockNumber":{"type":"string"},"capabilities":{"type":"object"},"facets":{"type":"array"},"implementation":{"type":["string","null"]},"reportHash":{"type":"string"},"failed":{"type":"array","items":{"type":"string"}}},"required":["ok","blockNumber","capabilities","facets","implementation","reportHash","failed"],"example":{"ok":true,"blockNumber":"83335219","capabilities":{"eip3009":true,"permit2":true},"facets":[],"implementation":null,"reportHash":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036","failed":[]}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned","source_hash"]}},"/tools/usdg_authorization_state":{"post":{"operationId":"tool_usdg_authorization_state","summary":"USDG authorization state on Robinhood Chain","description":"authorizationState(authorizer, nonce) on USDG. This is the authoritative replay check, because USDG replays do not revert.","tags":["usdg"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"authorizer":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"nonce":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},"required":["authorizer","nonce"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"authorizer":{"type":"string"},"nonce":{"type":"string"},"used":{"type":"boolean"}},"required":["authorizer","nonce","used"],"example":{"authorizer":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","nonce":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036","used":false}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/x402_inspect_endpoint":{"post":{"operationId":"tool_x402_inspect_endpoint","summary":"Inspect x402 endpoint","description":"Fetch a resource unpaid (SSRF-guarded) and decode its x402 v2 challenge: resource info, accepts[], extensions, latency and accepts hash. Use before paying any x402 API, to check its live price, network, asset and recipient without paying it.","tags":["x402"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"pattern":"^https?://","examples":["https://merchant.example/v1/quote"]}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"payable":{"type":"boolean"},"httpStatus":{"type":["integer","null"]},"latencyMs":{"type":["integer","null"]},"error":{"type":["string","null"]},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"array","items":{"type":"string"}},"acceptsHash":{"type":["string","null"]}},"required":["payable","httpStatus","latencyMs","error","resource","accepts","extensions","acceptsHash"],"example":{"payable":true,"httpStatus":402,"latencyMs":180,"error":null,"resource":{"url":"https://api.example.com/paid"},"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","maxTimeoutSeconds":300}],"extensions":["bazaar"],"acceptsHash":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036"}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["source_hash"]}},"/tools/x402_get_requirements":{"post":{"operationId":"tool_x402_get_requirements","summary":"Get payment requirements (x402)","description":"FRESH payment requirements for a resource (never cached; historical listings are not payment terms).","tags":["x402"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"pattern":"^https?://","examples":["https://merchant.example/v1/quote"]}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"accepts":{"type":"array","items":{"type":"object"}},"fetchedAt":{"type":"string"},"acceptsHash":{"type":"string"}},"required":["accepts","fetchedAt","acceptsHash"],"example":{"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","maxTimeoutSeconds":300}],"fetchedAt":"2026-10-11T08:00:00.000Z","acceptsHash":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036"}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["source_hash"]}},"/tools/x402_validate_requirements":{"post":{"operationId":"tool_x402_validate_requirements","summary":"Validate requirements (x402)","description":"Validate x402 v2 payment requirements (given inline or fetched from a URL) against CAIP-2, atomic amounts, the pinned asset and EIP-712 domain of each network (USDG on Robinhood Chain, USDC on Base) and scheme-specific extras. Use when an agent or merchant needs to check that x402 payment terms are well formed for Base USDC or Robinhood Chain USDG.","tags":["x402"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"pattern":"^https?://","examples":["https://merchant.example/v1/quote"]},"requirements":{"type":"object","additionalProperties":true,"properties":{"scheme":{"type":"string"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"}}}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string"},"network":{"type":"string"},"amount":{"type":"string"},"ok":{"type":"boolean"},"issues":{"type":"array","items":{"type":"string"}}},"required":["scheme","network","amount","ok","issues"],"example":{"scheme":"exact","network":"eip155:8453","amount":"7800","ok":true,"issues":[]}}}},"required":["results"],"example":{"results":[{"scheme":"exact","network":"eip155:8453","amount":"7800","ok":true,"issues":[]}]}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":[]}},"/tools/x402_simulate_payment":{"post":{"operationId":"tool_x402_simulate_payment","summary":"Simulate payment (x402)","description":"Pre-flight a payment WITHOUT signing: requirement validity, payer USDG balance, Permit2 allowance (for Permit2/upto), and whether gas-sponsored approval is offered.","tags":["x402"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"pattern":"^https?://","examples":["https://merchant.example/v1/quote"]},"requirements":{"type":"object","additionalProperties":true,"properties":{"scheme":{"type":"string"},"network":{"type":"string"},"amount":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"maxTimeoutSeconds":{"type":"integer"}}},"payer":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["payer"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"payer":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string"},"amount":{"type":"string"},"wouldSucceed":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}}},"required":["scheme","amount","wouldSucceed","reasons"],"example":{"scheme":"exact","amount":"7800","wouldSucceed":true,"reasons":[]}}},"gasSponsoredApprovalOffered":{"type":"boolean"}},"required":["payer","results","gasSponsoredApprovalOffered"],"example":{"payer":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","results":[{"scheme":"exact","amount":"7800","wouldSucceed":true,"reasons":[]}],"gasSponsoredApprovalOffered":false}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["block_pinned"]}},"/tools/x402_facilitator_status":{"post":{"operationId":"tool_x402_facilitator_status","summary":"Facilitator status (x402)","description":"A facilitator's live /supported and /ready (SSRF-guarded), or the status of Tollex's configured facilitator mesh.","tags":["x402"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"pattern":"^https?://","examples":["https://merchant.example/v1/quote"]}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"url":{"type":"string"},"supportedHttp":{"type":"integer"},"supported":{"type":"object","description":"the facilitator's /supported document"},"ready":{"type":"boolean"},"facilitators":{"type":"array","items":{"type":"object"}}},"required":[],"example":{"url":"https://facilitator.payai.network","supportedHttp":200,"supported":{"kinds":[{"x402Version":2,"scheme":"exact","network":"eip155:8453"}]},"ready":true}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":[]}},"/tools/x402_reconcile_operation":{"post":{"operationId":"tool_x402_reconcile_operation","summary":"Reconciliation check (x402)","description":"Read-only reconciliation check of a Tollex payment operation: durable state vs. chain evidence for its settlement transaction.","tags":["x402"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operationId":{"type":"string","pattern":"^[0-9a-f-]{36}$","examples":["00000000-0000-4000-8000-000000000001"]}},"required":["operationId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"found":{"type":"boolean"},"operationId":{"type":"string"},"state":{"type":"string"},"scheme":{"type":"string"},"transaction":{"type":["string","null"]},"chainState":{"type":"object"},"consistent":{"type":"boolean"},"failureClass":{"type":["string","null"]}},"required":["found"],"example":{"found":true,"operationId":"00000000-0000-4000-8000-000000000001","state":"reconciled","scheme":"exact","transaction":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036","chainState":{"found":true,"status":"success"},"consistent":true,"failureClass":null}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["chain_receipt"]}},"/tools/x402_verify_receipt":{"post":{"operationId":"tool_x402_verify_receipt","summary":"Verify execution receipt (x402)","description":"Verify a Tollex execution receipt against trusted signer addresses (or a merchant's well-known receipt keys URL).","tags":["x402"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"receipt":{"type":"object","additionalProperties":true},"trustedSigners":{"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"maxItems":10},"keysUrl":{"type":"string","maxLength":2048,"pattern":"^https?://","examples":["https://merchant.example/v1/quote"]}},"required":["receipt"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"valid":{"type":"boolean"},"recovered":{"type":"string","description":"recovered signer address"},"reasons":{"type":"array","items":{"type":"string"}}},"required":["valid","reasons"],"example":{"valid":true,"recovered":"0x69d778C105b7f94Bde775d7ae94F1daa56DAA88F","reasons":[]}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["signature"]}},"/tools/stock_tokens_list":{"post":{"operationId":"tool_stock_tokens_list","summary":"List Stock Tokens on Robinhood Chain","description":"Official Robinhood Stock Token registry: symbol, name, Robinhood Chain contract, current corporate-action multiplier, status.","tags":["stock-token"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":500}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"count":{"type":"integer"},"tokens":{"type":"array","items":{"type":"object"}}},"required":["count","tokens"],"example":{"count":1,"tokens":[{"symbol":"AAPL","name":"Apple","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168"}]}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["source_hash"]}},"/tools/stock_token_metadata":{"post":{"operationId":"tool_stock_token_metadata","summary":"Stock Token metadata on Robinhood Chain","description":"Registry entry for one Stock Token plus its on-chain ERC-20 metadata on Robinhood Chain.","tags":["stock-token"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","pattern":"^[A-Z][A-Z0-9.]{0,9}$"}},"required":["symbol"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"registry":{"type":"object","description":"Robinhood asset registry entry"},"onchain":{"type":"object","description":"token name, symbol, decimals, supply read on chain"}},"required":["registry","onchain"],"example":{"registry":{"symbol":"AAPL","name":"Apple"},"onchain":{"symbol":"AAPL","decimals":18}}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["source_hash","block_pinned"]}},"/tools/stock_token_quote":{"post":{"operationId":"tool_stock_token_quote","summary":"Stock Token quote on Robinhood Chain","description":"Multiplier-adjusted Stock Token mid price with halt and staleness checks; returns an input hash to commit into receipts. This is a price input only; payments settle in USDC on Base or USDG on Robinhood Chain. Use when a trading or research agent needs the price of a Robinhood Chain Stock Token (tokenized equity such as AAPL or TSLA).","tags":["stock-token"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","pattern":"^[A-Z][A-Z0-9.]{0,9}$"}},"required":["symbol"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"symbol":{"type":"string"},"price":{"type":"string","description":"multiplier-adjusted mid price, USD"},"currentMultiplier":{"type":"string"},"generatedAt":{"type":"string"},"source":{"type":"string"}},"required":["symbol","price","currentMultiplier","generatedAt","source"],"example":{"symbol":"AAPL","price":"227.43","currentMultiplier":"1","generatedAt":"2026-10-11T08:00:00.000Z","source":"api.robinhood.com/rhj/prices"}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["quote_input_hash"]}},"/tools/stock_token_halt_status":{"post":{"operationId":"tool_stock_token_halt_status","summary":"Stock Token halt status on Robinhood Chain","description":"Whether a Stock Token's underlying is in a trading halt, with the quote generation time. Use before trading a Robinhood Chain Stock Token, to avoid trading into a halt of the underlying stock.","tags":["stock-token"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","pattern":"^[A-Z][A-Z0-9.]{0,9}$"}},"required":["symbol"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"symbol":{"type":"string"},"isTradingHalt":{"type":"boolean"},"generatedAt":{"type":"string"}},"required":["symbol","isTradingHalt","generatedAt"],"example":{"symbol":"TSLA","isTradingHalt":false,"generatedAt":"2026-10-11T08:00:00.000Z"}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["source_hash"]}},"/tools/stock_token_corporate_actions":{"post":{"operationId":"tool_stock_token_corporate_actions","summary":"Stock Token corporate actions on Robinhood Chain","description":"Processed corporate actions (splits, cash/stock dividends) that change Stock Token multipliers, optionally for one symbol.","tags":["stock-token"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"symbol":{"type":"string","pattern":"^[A-Z][A-Z0-9.]{0,9}$"}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"count":{"type":"integer"},"actions":{"type":"array","items":{"type":"object"}}},"required":["count","actions"],"example":{"count":1,"actions":[{"symbol":"AAPL","type":"dividend","exDate":"2026-11-10"}]}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["source_hash"]}},"/tools/merchant_inspect":{"post":{"operationId":"tool_merchant_inspect","summary":"Inspect merchant (x402 merchant)","description":"Inspect a merchant endpoint: live x402 terms, Tollex receipt keys, A2A agent card and MCP server card if published (all SSRF-guarded, metadata treated as untrusted).","tags":["merchant"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"pattern":"^https?://","examples":["https://merchant.example/v1/quote"]}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"origin":{"type":"string"},"payable":{"type":"boolean"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"array","items":{"type":"string"}},"receiptKeys":{"type":["array","null"]},"a2aAgentCard":{"type":["object","null"]}},"required":["origin","payable","accepts"],"example":{"origin":"https://api.example.com","payable":true,"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"10000"}],"extensions":["bazaar"],"receiptKeys":null,"a2aAgentCard":null}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["source_hash"]}},"/tools/merchant_health":{"post":{"operationId":"tool_merchant_health","summary":"Merchant health (x402 merchant)","description":"Merchant availability: /health status, latency, and whether the resource currently answers with a valid x402 402 challenge.","tags":["merchant"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"pattern":"^https?://","examples":["https://merchant.example/v1/quote"]}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"origin":{"type":"string"},"healthHttp":{"type":"integer"},"healthLatencyMs":{"type":["integer","null"]},"challengeValid":{"type":"boolean"},"challengeLatencyMs":{"type":["integer","null"]},"error":{"type":["string","null"]}},"required":["origin","healthHttp","healthLatencyMs","challengeValid","challengeLatencyMs","error"],"example":{"origin":"https://api.example.com","healthHttp":200,"healthLatencyMs":95,"challengeValid":true,"challengeLatencyMs":140,"error":null}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":[]}},"/tools/merchant_payment_options":{"post":{"operationId":"tool_merchant_payment_options","summary":"Merchant payment options (x402 merchant)","description":"Normalised payment options for a resource: scheme, network, asset, human amount (USDG decimals), payTo, bound facilitator, gas sponsorship and receipt support.","tags":["merchant"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"pattern":"^https?://","examples":["https://merchant.example/v1/quote"]}},"required":["url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"payable":{"type":"boolean"},"options":{"type":"array","items":{"type":"object"}},"gasSponsoredApproval":{"type":"boolean"},"tollexReceipt":{"type":["object","null"]}},"required":["payable","options","gasSponsoredApproval","tollexReceipt"],"example":{"payable":true,"options":[{"scheme":"exact","network":"eip155:8453","amount":"10000"}],"gasSponsoredApproval":false,"tollexReceipt":null}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["source_hash"]}},"/tools/receipt_get":{"post":{"operationId":"tool_receipt_get","summary":"Get receipt (Tollex receipt)","description":"Fetch a stored Tollex execution receipt (body, content hash, signer, signature) by receipt id.","tags":["receipt"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"receiptId":{"type":"string","pattern":"^[A-Za-z0-9_-]{8,128}$"}},"required":["receiptId"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"found":{"type":"boolean"},"receipt":{"type":"object","description":"body, contentHash, signer, signature, format"},"settlementState":{"type":"string"},"batchId":{"type":["string","null"]}},"required":["found"],"example":{"found":true,"receipt":{"contentHash":"0x7a3d7400b27830f4f91c2c16a082486d67c1befecaec2f53b33f1f35d5b62036","signer":"0x69d778C105b7f94Bde775d7ae94F1daa56DAA88F","format":"eip712"},"settlementState":"finalized","batchId":null},"description":"When found is false, only { found: false } is returned."},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["signature"]}},"/tools/receipt_verify":{"post":{"operationId":"tool_receipt_verify","summary":"Verify receipt (Tollex receipt)","description":"Cryptographically verify a Tollex execution receipt against trusted signer addresses supplied by the caller. Use when an agent must prove a paid result is genuine: checks the signature and content hash of a Tollex receipt.","tags":["receipt"],"security":[],"parameters":[{"name":"x-tollex-quote","in":"header","required":false,"schema":{"type":"string"},"description":"Quote id from /v1/quote or /v1/resolve; binds price and input."},{"name":"x-tollex-resolution","in":"header","required":false,"schema":{"type":"string"},"description":"Resolution id this purchase follows."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"receipt":{"type":"object","additionalProperties":true},"trustedSigners":{"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"maxItems":10}},"required":["receipt","trustedSigners"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result with evidence; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","required":["tool","result","evidence"],"properties":{"tool":{"type":"object","properties":{"id":{"type":"string"},"version":{"type":"string"},"provider":{"type":"string"}}},"result":{"type":"object","properties":{"valid":{"type":"boolean"},"recovered":{"type":"string","description":"recovered signer address"},"reasons":{"type":"array","items":{"type":"string"}}},"required":["valid","reasons"],"example":{"valid":true,"recovered":"0x69d778C105b7f94Bde775d7ae94F1daa56DAA88F","reasons":[]}},"evidence":{"type":"array","items":{"type":"object"}},"untrustedOutput":{"type":"boolean"}}}}}},"202":{"description":"Payment submitted, settlement pending; poll the operation","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Input does not match the capability schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"409":{"description":"Quote expired, unknown or bound to other input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"The capability failed; payment is not settled for a failed result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}},"x-tollex-pricing":{"scheme":"exact","maxAmount":"7900","billing":"on_success","networks":["eip155:4663","eip155:8453"],"assets":[{"network":"eip155:4663","address":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG"},{"network":"eip155:8453","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"}]},"x-tollex-receipts":["request_hash","response_hash","pricing_terms","settlement_tx","assurance"],"x-tollex-evidence":["signature"]}},"/v1/agent-check":{"get":{"operationId":"agentCheck","summary":"First paid call: verify your x402 integration end to end","description":"First paid call: confirms your x402 integration end to end and returns live payment-rail and chain state with a signed receipt.","tags":["paid"],"security":[],"responses":{"200":{"description":"Result; the signed receipt arrives in the PAYMENT-RESPONSE header","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"x402 settlement response (base64 JSON) carrying the signed receipt"}},"content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"status":{"type":"string"},"paidWith":{"type":["object","null"],"description":"network, asset and amount of this payment","properties":{"network":{"type":"string"},"asset":{"type":"string"},"amount":{"type":"string"}}},"rails":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"network":{"type":"string"},"asset":{"type":"string"},"symbol":{"type":"string"},"acceptingNewPayments":{"type":"boolean"}}}},"chains":{"type":"object","description":"latest block per payment network, from Tollex's own chain views"},"verify":{"type":"object","description":"operation status URL, receipt keys URL, where the signed receipt is"},"checkedAt":{"type":"string"}},"required":["service","status","rails","chains","verify","checkedAt"]},"example":{"service":"Tollex","status":"ok","paidWith":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"7800"},"rails":[{"id":"base-usdc","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","acceptingNewPayments":true},{"id":"robinhood-usdg","network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","acceptingNewPayments":true}],"chains":{"eip155:4663":{"blockNumber":"83335219"},"eip155:8453":{"blockNumber":"36512000"}},"verify":{"operation":"https://api.tollex.org/tollex/operations/00000000-0000-4000-8000-000000000001","receiptKeys":"https://api.tollex.org/.well-known/tollex-receipt-keys","receipt":"PAYMENT-RESPONSE header: extensions['tollex-receipt'].info"},"checkedAt":"2026-10-11T08:00:00.000Z"}}}},"402":{"description":"Payment required (x402 v2). Terms are in the PAYMENT-REQUIRED header and the body.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"503":{"description":"Paid calls paused on every payment rail; retry after Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.0079"},"x402":{"version":2,"scheme":"exact","accepts":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","symbol":"USDG","amount":"7900"},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","amount":"7900"}]}}}}},"components":{"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 v2 payment payload (base64 JSON), signed by the payer for the terms in the 402 PAYMENT-REQUIRED header. No account or API key exists; each paid call carries its own payment."}},"schemas":{"ErrorEnvelope":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Machine code, e.g. invalid_intent, quote_expired, not_found."},"message":{"type":"string"}}},"IntentRequest":{"type":"object","additionalProperties":false,"required":["need"],"properties":{"need":{"type":"string","maxLength":500,"description":"What the agent needs. Used for matching only."},"input":{"type":"object","additionalProperties":true,"description":"Input for the capability; validated against each candidate's schema."},"limit":{"type":"integer","minimum":1,"maximum":50},"quote":{"type":"boolean","description":"Also return a hash-bound quote for the selected route (requires input)."},"constraints":{"type":"object","additionalProperties":false,"properties":{"maxCost":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Atomic units of the payment asset"},"asset":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"networks":{"type":"array","items":{"type":"string"}},"schemes":{"type":"array","items":{"enum":["exact","upto","batch-settlement"]}},"maxLatencyMs":{"type":"integer","minimum":1},"receiptRequired":{"type":"boolean"},"evidenceRequired":{"oneOf":[{"type":"boolean"},{"type":"array","items":{"type":"string"}}]},"allowedProviders":{"type":"array","items":{"type":"string"}},"blockedProviders":{"type":"array","items":{"type":"string"}},"allowedTools":{"type":"array","items":{"type":"string"}},"blockedTools":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}},"requiredFreshnessMs":{"type":"integer","minimum":1},"minSuccessRate":{"type":"number","minimum":0,"maximum":1},"maxSideEffects":{"enum":["none","read","write"]},"requireStableSchemaForMs":{"type":"integer","minimum":1,"description":"Current schema must have been in place this long"},"maxBreakingChanges30d":{"type":"integer","minimum":0,"description":"At most this many breaking schema changes in 30 days"},"includeExternal":{"type":"boolean","description":"Also consider external x402 merchants found by discovery. Where this service enables external execution they are bought with the caller's wallet and paid directly to the merchant; otherwise they are planned only."}}}}},"ResolveResponse":{"type":"object","required":["resolutionId","plan"],"properties":{"resolutionId":{"type":"string"},"correlationId":{"type":"string"},"plan":{"type":"object","required":["need","candidates","eligible","rejectedBy","evaluations"],"properties":{"need":{"type":"string"},"candidates":{"type":"integer"},"eligible":{"type":"integer"},"selected":{"anyOf":[{"type":"object","required":["toolId","provider"],"properties":{"toolId":{"type":"string"},"provider":{"type":"object","properties":{"id":{"type":"string"}}},"route":{"type":"object"}}},{"type":"null"}]},"reasons":{"type":"array","items":{"type":"string"}},"rejectedBy":{"type":"object","additionalProperties":{"type":"integer"}},"evaluations":{"type":"array","items":{"type":"object","required":["toolId","eligible"],"properties":{"toolId":{"type":"string"},"eligible":{"type":"boolean"},"rejections":{"type":"array"}}}},"diagnosis":{"type":"object","properties":{"suggestions":{"type":"array","items":{"type":"object","required":["kind","candidates"],"properties":{"kind":{"type":"string"},"candidates":{"type":"integer"},"detail":{"type":"string"}}}}}}}},"quote":{"type":"object","properties":{"quoteId":{"type":"string"},"toolId":{"type":"string"},"maxAmount":{"type":"string"},"expiresAt":{"type":"string"},"quoteHash":{"type":"string"}}}}},"Catalog":{"type":"object","required":["tools"],"properties":{"service":{"type":"string"},"tools":{"type":"array","items":{"type":"object","required":["id","name","pricingModel"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"category":{"type":"string"},"pricingModel":{"type":"object","required":["scheme","amount"],"properties":{"scheme":{"type":"string"},"amount":{"type":"string"}}}}}}}},"Health":{"type":"object","required":["providers"],"properties":{"providers":{"type":"object","additionalProperties":{"type":"object","properties":{"ok":{"type":"boolean"},"checkedAt":{"type":"string"}}}}}},"OperationStatus":{"type":"object","required":["id","state","status"],"properties":{"id":{"type":"string"},"state":{"type":"string"},"scheme":{"type":"string"},"network":{"type":"string"},"authorizedAmount":{"type":["string","null"]},"actualAmount":{"type":["string","null"]},"transaction":{"type":["string","null"]},"status":{"type":"object","required":["execution","settlement","reconciliation","terminal","moneyInFlight","next"],"properties":{"execution":{"type":"string"},"settlement":{"type":"string"},"reconciliation":{"type":"string"},"terminal":{"type":"boolean"},"moneyInFlight":{"type":"boolean"},"next":{"type":"string"}}},"receipts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"}}}}}},"SignedReceipt":{"type":"object","required":["body","contentHash","signer","signature","format"],"properties":{"body":{"type":"object","required":["receiptId","operationId"],"properties":{"receiptId":{"type":"string"},"operationId":{"type":"string"}}},"contentHash":{"type":"string"},"signer":{"type":"string"},"signature":{"type":"string"},"format":{"type":"string"}}},"ReceiptKeys":{"type":"object","required":["keys"],"properties":{"version":{"type":"integer"},"merchant":{"type":"string"},"keys":{"type":"array","items":{"type":"object","required":["address","status"],"properties":{"keyId":{"type":"string"},"address":{"type":"string"},"status":{"type":"string","enum":["active","retired","revoked"]}}}}}},"ToolResult":{"type":"object","properties":{"tool":{"type":"object"},"result":{},"evidence":{"type":"array"},"untrustedOutput":{"type":"boolean"}}},"PaymentRequired":{"type":"object","required":["x402Version","accepts"],"properties":{"x402Version":{"type":"integer"},"accepts":{"type":"array","items":{"type":"object","required":["scheme","network","amount","asset","payTo"]}},"resource":{"type":"object"}}}}}}