{"openapi":"3.1.0","info":{"title":"NO HANDS AI — x402 Services","version":"0.2.0","description":"Pay-per-request utilities, API inspection, chain data and market quotes. Standard x402 v2 USDC on Base. Free documentation; no account registration."},"servers":[{"url":"https://nohands-coinbase-bazaar.bytoken2023.workers.dev"}],"paths":{"/v1/origin-due-diligence":{"get":{"operationId":"inspectOrigin","summary":"x402 Origin Due Diligence","description":"Inspect a public HTTPS origin for advertised APIs, OpenAPI documentation and x402 discovery metadata before choosing a paid service. Price: $0.010001 USDC on Base.","parameters":[{"name":"server_url","in":"query","required":true,"schema":{"type":"string","pattern":"^https://","description":"Public HTTPS server URL to inspect. The report examines its origin."},"example":"https://example.com"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","required":["origin","observed_at","homepage","discovery","openapi","warnings","payment_tested"],"properties":{"origin":{"type":"string"},"observed_at":{"type":"string"},"homepage":{"type":"object"},"discovery":{"type":"object"},"openapi":{"type":"object"},"warnings":{"type":"array","items":{"type":"string"}},"payment_tested":{"type":"boolean","const":false}}},"example":{"origin":"https://example.com","observed_at":"2026-11-01T00:00:00.000Z","homepage":{"status":200,"content_type":"text/html"},"discovery":{"url":"https://example.com/.well-known/x402","status":404,"available":false,"resources":[]},"openapi":{"url":"https://example.com/openapi.json","status":404,"available":false,"paths":[]},"warnings":["A supported discovery resource list was not found at the inspected URL."],"payment_tested":false}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/endpoint-preflight":{"get":{"operationId":"inspectEndpoint","summary":"x402 Endpoint Preflight","description":"Inspect a public HTTPS endpoint without paying it. Read its HTTP 402 payment requirements, Base/USDC pricing and Bazaar discovery schema. Price: $0.015002 USDC on Base.","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","pattern":"^https://","description":"Exact public HTTPS endpoint URL to inspect without sending a payment."},"example":"https://example.com/paid-api"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","required":["target_url","observed_at","http_status","x402","warnings","payment_tested"],"properties":{"target_url":{"type":"string"},"observed_at":{"type":"string"},"http_status":{"type":["integer","null"]},"x402":{"type":"object"},"warnings":{"type":"array","items":{"type":"string"}},"payment_tested":{"type":"boolean","const":false}}},"example":{"target_url":"https://example.com/paid-api","observed_at":"2026-11-01T00:00:00.000Z","http_status":402,"x402":{"detected":true,"version":2,"requirements_valid":true,"accepts":[],"bazaar":{"present":false,"spec_valid":false,"schema_validation":"not_performed"}},"warnings":[],"payment_tested":false}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/base/gas-fee-quote":{"get":{"operationId":"getBaseGasFeeQuote","summary":"Base Gas Fee Quote","description":"Return live Base gas fees and an estimated transaction cost for a caller-supplied gas limit. Price: $0.003002 USDC on Base.","parameters":[{"name":"gas_limit","in":"query","required":true,"schema":{"type":"string","pattern":"^[0-9]+$","description":"Expected transaction gas limit.","example":"21000"},"example":"21000"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string"},"schema_version":{"type":"string"},"network":{"type":"string"},"fetched_at":{"type":"string"},"block_number":{"type":"integer"},"gas_limit":{"type":"string"},"fees":{"type":"object","properties":{"gas_price_wei":{"type":"string"},"gas_price_gwei":{"type":"string"},"base_fee_wei":{"type":"string"},"base_fee_gwei":{"type":"string"},"priority_fee_wei":{"type":"string"},"priority_fee_gwei":{"type":"string"}},"additionalProperties":true},"estimated_cost":{"type":"object","properties":{"wei":{"type":"string"},"eth":{"type":"string"}},"additionalProperties":true},"block_utilization_percent":{"type":"number"},"provenance":{"type":"object","properties":{"rpc_providers":{"type":"array","items":{"type":"string"}},"block_tag":{"type":"string"}},"additionalProperties":true},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true,"x-schema-family":"OPERATION_RUNTIME_RESULT","x-schema-authority":"REPRESENTATIVE_RUNTIME_FIXTURE"},"example":{"product":"base-gas-fee-quote","schema_version":"1.0","network":"eip155:8453","fetched_at":"2026-07-24T00:00:00.000Z","block_number":100,"gas_limit":"21000","fees":{"gas_price_wei":"1000000000","gas_price_gwei":"1","base_fee_wei":"1000000000","base_fee_gwei":"1","priority_fee_wei":"2000000000","priority_fee_gwei":"2"},"estimated_cost":{"wei":"21000000000000","eth":"0.000021"},"block_utilization_percent":0.2625,"provenance":{"rpc_providers":["https://base.blockscout.com/api/eth-rpc","https://mainnet.base.org","https://base-rpc.publicnode.com"],"block_tag":"latest"},"limitations":["The estimate uses the supplied gas limit and current gas price, not transaction simulation.","Fees can change before a transaction is submitted or included."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/base/nonce-readiness":{"get":{"operationId":"getBaseNonceReadiness","summary":"Base Nonce Readiness","description":"Compare confirmed and pending Base nonces before an autonomous transaction is signed. Price: $0.003004 USDC on Base.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Base account whose transaction nonce should be checked.","example":"0x94F751f04b98507D31b500b7Ed50bE68A1514873"},"example":"0x94F751f04b98507D31b500b7Ed50bE68A1514873"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string"},"schema_version":{"type":"string"},"network":{"type":"string"},"address":{"type":"string"},"fetched_at":{"type":"string"},"confirmed_nonce":{"type":"string"},"pending_nonce":{"type":"string"},"pending_transaction_count":{"type":"string"},"ready":{"type":"boolean"},"decision_hint":{"type":"string"},"provenance":{"type":"object","properties":{"rpc_providers":{"type":"array","items":{"type":"string"}},"confirmed_block_tag":{"type":"string"},"pending_block_tag":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true,"x-schema-family":"OPERATION_RUNTIME_RESULT","x-schema-authority":"REPRESENTATIVE_RUNTIME_FIXTURE"},"example":{"product":"base-nonce-readiness","schema_version":"1.0","network":"eip155:8453","address":"0x94F751f04b98507D31b500b7Ed50bE68A1514873","fetched_at":"2026-07-24T00:00:00.000Z","confirmed_nonce":"16","pending_nonce":"16","pending_transaction_count":"0","ready":true,"decision_hint":"Use nonce 16 for the next transaction.","provenance":{"rpc_providers":["https://base.blockscout.com/api/eth-rpc","https://mainnet.base.org","https://base-rpc.publicnode.com"],"confirmed_block_tag":"latest","pending_block_tag":"pending"}}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/base/stablecoin-balance":{"get":{"operationId":"getBaseStablecoinBalance","summary":"Base Stablecoin Balance","description":"Return live Base USDC, USDT, and DAI balances with public USD reference rates. Price: $0.003005 USDC on Base.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Base wallet or contract whose stablecoin balances should be read.","example":"0x94F751f04b98507D31b500b7Ed50bE68A1514873"},"example":"0x94F751f04b98507D31b500b7Ed50bE68A1514873"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string"},"schema_version":{"type":"string"},"network":{"type":"string"},"address":{"type":"string"},"fetched_at":{"type":"string"},"total_estimated_value_usd":{"type":"number"},"assets":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"contract":{"type":"string"},"atomic":{"type":"string"},"balance":{"type":"string"},"reference_rate_usd":{"type":["number","null"]},"estimated_value_usd":{"type":["number","null"]},"reputation":{"type":["string","null"]}},"additionalProperties":true}},"provenance":{"type":"object","properties":{"rpc_providers":{"type":"array","items":{"type":"string"}},"block_tag":{"type":"string"}},"additionalProperties":true},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true,"x-schema-family":"OPERATION_RUNTIME_RESULT","x-schema-authority":"REPRESENTATIVE_RUNTIME_FIXTURE"},"example":{"product":"base-stablecoin-balance","schema_version":"1.0","network":"eip155:8453","address":"0x94F751f04b98507D31b500b7Ed50bE68A1514873","fetched_at":"2026-07-24T00:00:00.000Z","total_estimated_value_usd":1,"assets":[{"symbol":"USDC","contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","atomic":"1000000","balance":"1","reference_rate_usd":1,"estimated_value_usd":1,"reputation":"ok"},{"symbol":"USDT","contract":"0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2","atomic":"0","balance":"0","reference_rate_usd":1,"estimated_value_usd":0,"reputation":"ok"},{"symbol":"DAI","contract":"0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb","atomic":"500000","balance":"0.0000000000005","reference_rate_usd":1,"estimated_value_usd":0,"reputation":"ok"}],"provenance":{"rpc_providers":["https://base.blockscout.com/api/eth-rpc","https://mainnet.base.org","https://base-rpc.publicnode.com"],"block_tag":"latest"},"limitations":["Reference rates are public metadata and may lag market prices.","Only the three listed Base stablecoin contracts are included."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/base/dex-market-monitor":{"get":{"operationId":"getBaseDexMarketMonitor","summary":"Base DEX Market Monitor","description":"Monitor Base DEX price, liquidity, volume, and trade activity for a token. Price: $0.005004 USDC on Base.","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Base token contract to monitor across DEX pairs.","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"pretrade_evidence":{"type":"object","description":"Data evidence only, never a trade authorization or a safety claim. RECENT_VERIFIED requires a source timestamp; without one the status is at most NOT_VERIFIED. Missing or unbound market data is INCOMPLETE and legacy zero values are labelled as defaults, not measurements. pairs[i] describes the legacy pairs[i]; pairs[0] describes deepest_pair.","properties":{"evidence_version":{"type":"string"},"decision_scope":{"type":"string","enum":["DATA_EVIDENCE_ONLY_NOT_TRADE_AUTHORIZATION"]},"evidence_status":{"type":"string","enum":["RECENT_VERIFIED","NOT_VERIFIED","STALE","INCOMPLETE","SOURCE_UNAVAILABLE"]},"reason_codes":{"type":"array","items":{"type":"string"}},"subject":{"type":"object","additionalProperties":true},"observation":{"type":"object","description":"observed_at_field names the response field holding the gateway fetch time. It is not a source data as-of time; source_as_of is null because neither provider returns one.","properties":{"observed_at_field":{"type":"string","enum":["fetched_at"]},"observed_at_basis":{"type":"string","enum":["GATEWAY_FETCH_CLOCK"]},"source_as_of":{"type":["string","null"]},"source_freshness":{"type":"string","enum":["RECENT_VERIFIED","NOT_VERIFIED","STALE","INCOMPLETE","SOURCE_UNAVAILABLE"]},"source_freshness_reason":{"type":["string","null"]},"recheck_after_seconds":{"type":"integer"}},"required":["observed_at_field","observed_at_basis","source_as_of","source_freshness","recheck_after_seconds"],"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","additionalProperties":true}},"coverage":{"type":"object","additionalProperties":true},"aggregate_top5_basis":{"type":"string"},"pairs":{"type":"array","items":{"type":"object","properties":{"pair_address":{"type":["string","null"]},"requested_token_role":{"type":"string","enum":["BASE","QUOTE","UNBOUND"]},"base_token_address":{"type":["string","null"]},"quote_token_address":{"type":["string","null"]},"price_usd_applies_to_requested_token":{"type":"boolean"},"missing_fields":{"type":"array","items":{"type":"string"}},"invalid_fields":{"type":"array","items":{"type":"string"}},"flags":{"type":"array","items":{"type":"string"}},"evidence_status":{"type":"string","enum":["OBSERVED","INCOMPLETE"]}},"required":["pair_address","requested_token_role","evidence_status"],"additionalProperties":true}}},"required":["evidence_version","decision_scope","evidence_status","reason_codes","observation","sources","pairs"],"additionalProperties":true}},"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"base-dex-market-monitor","schema_version":"1.0","network":"eip155:8453","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","fetched_at":"2026-07-24T00:00:00.000Z","pair_count":1,"aggregate_top5":{"liquidity_usd":100000,"volume_24h_usd":10000,"buys_24h":20,"sells_24h":15},"deepest_pair":{"dex":"illustrative-dex","pair_address":"0x1111111111111111111111111111111111111111","base_token":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"},"quote_token":{"address":"0x4200000000000000000000000000000000000006","symbol":"WETH"},"price_usd":"1.00","liquidity_usd":100000,"volume_24h_usd":10000,"buys_24h":20,"sells_24h":15,"price_change":{"h24":0.1},"pair_created_at":"2026-07-01T00:00:00.000Z"},"provenance":{"provider":"DexScreener","url":"https://dexscreener.com/search?q=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"limitations":["Illustrative partial result; live output also carries pretrade_evidence and per-pair evidence.","DEX prices and liquidity can change between observation and execution."],"pairs":[{"dex":"illustrative-dex","pair_address":"0x1111111111111111111111111111111111111111","base_token":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC"},"quote_token":{"address":"0x4200000000000000000000000000000000000006","symbol":"WETH"},"price_usd":"1.00","liquidity_usd":100000,"volume_24h_usd":10000,"buys_24h":20,"sells_24h":15,"price_change":{"h24":0.1},"pair_created_at":"2026-07-01T00:00:00.000Z"}]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/prediction/market-snapshot":{"get":{"operationId":"getPredictionMarketSnapshot","summary":"Prediction Market Snapshot","description":"Return a public Kalshi prediction-market quote, volume, open interest, and orderbook snapshot. Price: $0.005010 USDC on Base.","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._-]{3,160}$","description":"Kalshi market ticker.","example":"KXWCFIRSTGOAL-26JUN21ESPKSA-ESPLYAMAL10"},"example":"KXMVECROSSCATEGORY-S2026B4KNVZMEBQJGGQIL-RLC5B5WCW"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"prediction-market-snapshot","schema_version":"1.0","venue":"Kalshi","ticker":"KXMVECROSSCATEGORY-S2026B4KNVZMEBQJGGQIL-RLC5B5WCW","fetched_at":"2026-07-24T00:00:00.000Z","market":{"event_ticker":"EXAMPLE","title":"Illustrative prediction market","yes_subtitle":null,"no_subtitle":null,"status":"open","close_time":null,"yes_bid_dollars":"0.40","yes_ask_dollars":"0.42","no_bid_dollars":null,"no_ask_dollars":null,"last_price_dollars":null,"previous_price_dollars":null,"volume":"100","volume_24h":null,"open_interest":"50","liquidity_dollars":null,"result":null},"orderbook":{"yes_bids":[{"price_dollars":"0.40","size":"10"}],"no_bids":[{"price_dollars":"0.58","size":"15"}]},"provenance":{"provider":"Kalshi public Trade API","market_url":"https://external-api.kalshi.com/trade-api/v2/markets/KXMVECROSSCATEGORY-S2026B4KNVZMEBQJGGQIL-RLC5B5WCW","orderbook_url":"https://external-api.kalshi.com/trade-api/v2/markets/KXMVECROSSCATEGORY-S2026B4KNVZMEBQJGGQIL-RLC5B5WCW/orderbook?depth=10"},"limitations":["This is a read-only snapshot and does not place or recommend trades.","Orderbook levels and quotes can change immediately after retrieval."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/software/npm-package-preflight":{"get":{"operationId":"getNpmPackagePreflight","summary":"npm Package Preflight","description":"Check npm package metadata, maintenance signals, deprecation, license, dependencies, and OSV vulnerabilities. Price: $0.015000 USDC on Base.","parameters":[{"name":"package","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":214,"pattern":"^(?:@[A-Za-z0-9][A-Za-z0-9._~-]*/)?[A-Za-z0-9][A-Za-z0-9._~-]*$","description":"npm package name, including an optional scope.","example":"express"},"example":"express"},{"name":"version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":80,"description":"Exact npm version or latest. Defaults to latest.","example":"4.18.2"},"example":"4.18.2"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"npm-package-preflight","schema_version":"1.0","package":"express","requested_version":"4.18.2","resolved_version":"4.18.2","fetched_at":"2026-07-24T00:00:00.000Z","assessment":{"risk_level":"low","risk_score":0,"flags":[],"decision_hint":"No deprecation or known OSV vulnerability was found for this exact version."},"metadata":{"latest_version":"4.18.2","published_at":"2026-07-24T00:00:00.000Z","publish_age_days":101,"deprecated":null,"license":"MIT","maintainers":[],"dependency_count":1,"optional_dependency_count":0,"peer_dependency_count":0,"repository":null,"homepage":null,"integrity":null},"vulnerabilities":[],"provenance":{"npm":"https://www.npmjs.com/package/express/v/4.18.2","osv":"https://osv.dev/"},"limitations":["OSV results cover disclosed vulnerabilities and cannot prove a package is safe.","This does not execute, install, or inspect package tarball contents or lifecycle scripts."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/web/url-change-fingerprint":{"get":{"operationId":"getUrlChangeFingerprint","summary":"URL Change Fingerprint","description":"Fetch a public URL and return redirect, metadata, cache validators, and a SHA-256 content fingerprint. Price: $0.003013 USDC on Base.","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","pattern":"^https?://","maxLength":2048,"description":"Public HTTP(S) document URL to fingerprint.","example":"https://www.cloudflare.com/"},"example":"https://www.cloudflare.com/"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"url-change-fingerprint","schema_version":"1.0","requested_url":"https://example.com/","final_url":"https://example.com/","fetched_at":"2026-07-24T00:00:00.000Z","http_status":200,"redirects":[],"content":{"content_type":"text/html","bytes_hashed":35,"truncated":false,"sha256":"384977231a8233c8f18bbbcf383924a223f02e6c17f0a6a8f2ef87ae4092dd27","etag":"\"illustrative-etag\"","last_modified":"Fri, 24 Jul 2026 00:00:00 GMT","title":"Example","canonical":null},"decision_hint":"Compare sha256, etag, or last_modified with a previous snapshot to detect a change.","limitations":["Illustrative offline response; this is not a live observation of example.com."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/web/feed-snapshot":{"get":{"operationId":"getFeedSnapshot","summary":"Feed Snapshot","description":"Normalize the latest entries from a public RSS or Atom feed with stable item fingerprints. Price: $0.003012 USDC on Base.","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","pattern":"^https?://","maxLength":2048,"description":"Public RSS or Atom feed URL.","example":"https://github.com/cloudflare/workers-sdk/releases.atom"},"example":"https://github.com/cloudflare/workers-sdk/releases.atom"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"feed-snapshot","schema_version":"1.0","requested_url":"https://github.com/cloudflare/workers-sdk/releases.atom","final_url":"https://github.com/cloudflare/workers-sdk/releases.atom","fetched_at":"2026-07-24T00:00:00.000Z","format":"rss","redirects":[],"feed":{"title":"Example Feed","description":"Illustrative feed"},"item_count":1,"items":[{"title":"Example entry","link":"https://example.com/posts/1","id":"example-1","published":"2026-07-24T00:00:00.000Z","summary":"Illustrative entry.","fingerprint":"b742e8a0121631a3c17c8f16c9e8223d618ce2e6cb07c25226d341c15108675c"}],"limitations":["Only the first 20 entries in the returned feed are normalized.","Malformed XML or feeds rendered only by JavaScript may not be parsed completely."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/agent/a2a-card-preflight":{"get":{"operationId":"getA2aAgentCardPreflight","summary":"A2A Agent Card Preflight","description":"Discover and validate a public A2A Agent Card, its skills, provider, authentication, endpoint consistency, and unsafe URLs. Price: $0.020000 USDC on Base.","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","pattern":"^https?://","maxLength":2048,"description":"Public agent origin or direct Agent Card URL.","example":"https://base-agent-preflight.bytoken2023.workers.dev"},"example":"https://base-agent-preflight.bytoken2023.workers.dev"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"a2a-agent-card-preflight","schema_version":"1.0","requested_url":"https://base-agent-preflight.bytoken2023.workers.dev","card_url":"https://base-agent-preflight.bytoken2023.workers.dev/.well-known/agent-card.json","fetched_at":"2026-07-24T00:00:00.000Z","redirects":[],"assessment":{"risk_level":"low","risk_score":5,"flags":[{"code":"AUTHENTICATION_NOT_DECLARED","severity":"info","detail":"The Agent Card does not declare authentication or security schemes."}],"decision_hint":"The Agent Card is structurally usable; this does not prove the agent is trustworthy."},"agent":{"name":"Illustrative Agent","description":null,"url":"https://base-agent-preflight.bytoken2023.workers.dev/a2a","version":"1.0","protocol_version":null,"preferred_transport":null,"provider":null,"capabilities":null,"authentication":null,"default_input_modes":[],"default_output_modes":[],"skill_count":1,"skills":[{"id":"example-skill","name":"Example skill","description":null,"tags":["example"]}]},"limitations":["A valid Agent Card is self-declared metadata and does not prove operator identity or runtime behavior.","This check does not invoke agent skills or send credentials."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/web/openapi-preflight":{"get":{"operationId":"getOpenapiSpecPreflight","summary":"OpenAPI Spec Preflight","description":"Validate a public OpenAPI JSON or YAML document, server URLs, authentication declarations, operation coverage, and content fingerprint. Price: $0.015003 USDC on Base.","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","pattern":"^https?://","maxLength":2048,"description":"Public OpenAPI JSON or YAML document URL.","example":"https://base-agent-preflight.bytoken2023.workers.dev/openapi.json"},"example":"https://nohands-coinbase-bazaar.bytoken2023.workers.dev/openapi.json"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"openapi-spec-preflight","schema_version":"1.0","requested_url":"https://nohands-coinbase-bazaar.bytoken2023.workers.dev/openapi.json","final_url":"https://nohands-coinbase-bazaar.bytoken2023.workers.dev/openapi.json","fetched_at":"2026-07-24T00:00:00.000Z","redirects":[],"fingerprint_sha256":"4f519b6dffc2380806c3f6fb52a2a42dacdefca0cc24934172db580fc8cb5456","assessment":{"risk_level":"low","risk_score":5,"flags":[{"code":"NO_SECURITY_SCHEMES","severity":"info","detail":"The specification does not define authentication or security schemes."}],"decision_hint":"The specification is structurally usable; upstream behavior can still differ."},"specification":{"title":"Illustrative API","version":"3.1.0","api_version":"1.0.0","path_count":1,"operation_count":1,"operations_missing_id":0,"security_scheme_names":[],"servers":[{"declared":"https://example.com","resolved":"https://example.com/","valid_public_url":true,"reason":null}]},"limitations":["This performs structural checks and does not prove the server implements the specification.","External references are not recursively downloaded or validated."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/web/domain-trust-preflight":{"get":{"operationId":"getDomainTrustPreflight","summary":"Domain Trust Preflight","description":"Inspect public DNS, DNSSEC, mail, CNAME resolution, RDAP registration age, expiration, and domain trust signals. Price: $0.015001 USDC on Base.","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","pattern":"^(?=.{1,253}$)(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)+[A-Za-z]{2,63}$","description":"Registrable or delegated public DNS domain name.","example":"github.com"},"example":"github.com"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"domain-trust-preflight","schema_version":"1.0","domain":"github.com","fetched_at":"2026-07-24T00:00:00.000Z","assessment":{"risk_level":"low","risk_score":5,"flags":[{"code":"RDAP_UNAVAILABLE","severity":"info","detail":"Public registration metadata was not available from the RDAP bootstrap service."}],"decision_hint":"No major DNS or registration warning was observed; this is not proof of ownership."},"dns":{"resolves":true,"dnssec_authenticated":true,"a":[{"name":null,"type":1,"ttl":0,"data":"93.184.215.14"}],"aaaa":[],"cname":[],"mx":[],"dnskey_count":0},"registration":null,"provenance":{"dns_provider":"Cloudflare DNS over HTTPS","rdap_provider":"RDAP bootstrap service"},"limitations":["Domain age, DNSSEC, and mail configuration do not prove that a service is legitimate.","A dangling CNAME warning is a candidate signal and does not prove takeover is possible.","RDAP fields vary by registry and can be redacted or stale."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/software/pypi-package-preflight":{"get":{"operationId":"getPypiPackagePreflight","summary":"PyPI Package Preflight","description":"Check PyPI package metadata, release age, yanked status, Python requirements, dependencies, license, and OSV vulnerabilities. Price: $0.005011 USDC on Base.","parameters":[{"name":"package","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9](?:[A-Za-z0-9._-]{0,198}[A-Za-z0-9])?$","description":"PyPI project name.","example":"requests"},"example":"requests"},{"name":"version","in":"query","required":false,"schema":{"type":"string","pattern":"^(?:latest|[A-Za-z0-9][A-Za-z0-9._+!-]{0,99})$","description":"Exact PyPI version or latest. Defaults to latest.","example":"latest"},"example":"latest"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"pypi-package-preflight","schema_version":"1.0","package":"requests","requested_version":"latest","resolved_version":"1.0.0","fetched_at":"2026-07-24T00:00:00.000Z","assessment":{"risk_level":"low","risk_score":0,"flags":[],"decision_hint":"No major public package warning was found; pin hashes and review provenance before installation."},"metadata":{"name":"example-package","summary":null,"author":null,"project_url":null,"package_url":null,"license":"MIT","requires_python":">=3.10","dependency_count":1,"dependencies":["example-dependency>=1"],"file_count":1,"all_files_yanked":false,"last_published_at":"2026-07-24T00:00:00.000Z","stale_days":101},"vulnerabilities":[],"provenance":{"provider":"PyPI JSON API and Google OSV","pypi_url":"https://pypi.org/project/requests/1.0.0/"},"limitations":["Package metadata is publisher-controlled and does not prove the uploaded artifacts are safe.","OSV coverage is not exhaustive and newly disclosed issues may not appear immediately.","This check does not inspect wheel or source-distribution contents."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/x402/resource-compare":{"get":{"operationId":"getX402ResourceCompare","summary":"x402 Resource Compare","description":"Compare two to five x402 resources or servers by price, payment metadata, schema quality, seller consistency, and budget fit. Price: $0.010002 USDC on Base.","parameters":[{"name":"resources","in":"query","required":true,"schema":{"type":"string","pattern":"^https?://","maxLength":4096,"description":"Comma-separated list of two to five public x402 resource or server URLs.","example":"https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/base/alpha-risk,https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/base/token-alpha-snapshot"},"example":"https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/base/alpha-risk,https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/base/token-alpha-snapshot"},{"name":"budget_usdc","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Optional maximum acceptable spend for one chosen resource.","example":"0.02"},"example":"0.02"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"x402-resource-compare","schema_version":"1.0","fetched_at":"2026-07-24T00:00:00.000Z","budget_usdc":0.02,"recommendation":{"rank":1,"url":"https://example.com/a","description":"Illustrative resource A","pay_to":"0x94F751f04b98507D31b500b7Ed50bE68A1514873","amount_usdc":0.01,"risk_level":"low","score":85,"flags":[]},"candidates":[{"rank":1,"url":"https://example.com/a","description":"Illustrative resource A","pay_to":"0x94F751f04b98507D31b500b7Ed50bE68A1514873","amount_usdc":0.01,"risk_level":"low","score":85,"flags":[]},{"rank":2,"url":"https://example.com/b","description":"Illustrative resource B","pay_to":"0x94F751f04b98507D31b500b7Ed50bE68A1514873","amount_usdc":0.02,"risk_level":"low","score":80,"flags":[]}],"decision_hint":"Use the top-ranked resource for low-value autonomous spend with Payment Guard.","limitations":["Comparison is based on unpaid x402 metadata and caller-supplied URLs.","A lower price does not prove better delivery quality."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/agent/rpc-preflight":{"get":{"operationId":"getAgentRpcPreflight","summary":"Agent RPC Preflight","description":"Preflight an agent RPC or x402 chain-data request before payment: endpoint origin, method risk, chain fit, price, and budget checks. Price: $0.005001 USDC on Base.","parameters":[{"name":"endpoint_url","in":"query","required":true,"schema":{"type":"string","pattern":"^https?://","maxLength":2048,"description":"RPC, x402, REST, or indexed chain-data endpoint URL.","example":"https://x402.example.com/rpc/base"},"example":"https://x402.example.com/rpc/base"},{"name":"chain","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9:_ -]{2,80}$","description":"Requested chain or CAIP-2 network label.","example":"base"},"example":"base"},{"name":"method","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{2,80}$","description":"RPC method, REST operation, or query action.","example":"eth_blockNumber"},"example":"eth_blockNumber"},{"name":"max_price_usdc","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Maximum acceptable price for this request.","example":"0.001"},"example":"0.001"},{"name":"session_budget_usdc","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Remaining session budget available to the agent.","example":"1.00"},"example":"1.00"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"agent-rpc-preflight","schema_version":"1.0","fetched_at":"2026-07-24T00:00:00.000Z","endpoint":{"requested_url":"https://x402.example.com/rpc/base","origin":"https://x402.example.com","host":"x402.example.com","chain":"base","method":"eth_blockNumber"},"payment_context":{"max_price_usdc":0.001,"session_budget_usdc":1,"budget_fit":true},"assessment":{"decision":"ALLOW","risk_level":"low","risk_score":0,"flags":[],"next_action":"Allow low-value read-only use with normal budget guardrails."},"recommended_next_checks":["Run rpc-capability-probe when the workflow needs historical state, trace, WebSocket, or local-fork compatibility.","Run x402-rpc-payment-guard immediately before wallet signing."],"limitations":["This endpoint does not call the upstream data provider.","Capability support must be verified by a live probe before production reliance."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/chain/rpc-capability-probe":{"get":{"operationId":"getRpcCapabilityProbe","summary":"RPC Capability Probe","description":"Score whether an RPC route likely fits agent chain-data work: logs, storage, historical reads, trace, WebSocket, and local-fork research. Price: $0.005009 USDC on Base.","parameters":[{"name":"chain","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9:_ -]{2,80}$","description":"Requested chain or CAIP-2 network label.","example":"ethereum"},"example":"ethereum"},{"name":"methods","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.,:-]{2,400}$","description":"Comma-separated RPC methods the workflow needs.","example":"eth_blockNumber,eth_getLogs,eth_getStorageAt"},"example":"eth_blockNumber,eth_getLogs,eth_getStorageAt"},{"name":"historical_block","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]{1,12}$","description":"Optional historical block number needed by the workflow.","example":"17000000"},"example":"17000000"},{"name":"requires_trace","in":"query","required":false,"schema":{"type":"string","pattern":"^(?:true|false)$","description":"Whether debug/trace methods are required.","example":"false"},"example":"false"},{"name":"requires_websocket","in":"query","required":false,"schema":{"type":"string","pattern":"^(?:true|false)$","description":"Whether subscription/WebSocket support is required.","example":"false"},"example":"false"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"rpc-capability-probe","schema_version":"1.0","fetched_at":"2026-07-24T00:00:00.000Z","chain":"ethereum","requested_capabilities":{"methods":["eth_blockNumber","eth_getLogs","eth_getStorageAt"],"historical_block":17000000,"requires_trace":false,"requires_websocket":false},"assessment":{"research_fit":"needs_live_probe","fit_score":60,"risk_level":"medium","flags":[{"code":"ARCHIVE_STATE_REQUIRED","severity":"medium","detail":"Historical block reads require archive or equivalent state support."}],"local_fork_readiness":"verify_archive_and_trace_before_use"},"recommended_live_probes":["eth_chainId","eth_blockNumber","eth_getLogs","eth_getStorageAt at the target block"],"limitations":["This is a planning probe and does not perform live RPC calls.","Provider-specific archive, trace, REST, gRPC-Web, and WebSocket behavior must be tested on the final route."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/agent/chain-data-route-plan":{"get":{"operationId":"getAgentChainDataRoutePlan","summary":"Agent Chain Data Route Plan","description":"Plan a budget-aware route for agent chain-data tasks across RPC reads, indexed data, cached intelligence, and payment review. Price: $0.005000 USDC on Base.","parameters":[{"name":"task","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":500,"description":"Natural-language chain-data task.","example":"investigate recent Base token transfers before payment"},"example":"investigate recent Base token transfers before payment"},{"name":"chain","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9:_ -]{2,80}$","description":"Requested chain or CAIP-2 network label.","example":"base"},"example":"base"},{"name":"data_need","in":"query","required":false,"schema":{"type":"string","enum":["rpc","logs","storage","trace","indexed","sql","fork","mixed"],"description":"Primary data access shape.","example":"logs"},"example":"logs"},{"name":"budget_usdc","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Maximum planned spend for this route.","example":"0.02"},"example":"0.02"},{"name":"risk_tolerance","in":"query","required":false,"schema":{"type":"string","enum":["low","medium","high"],"description":"How much uncertainty the buyer can tolerate.","example":"medium"},"example":"medium"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"agent-chain-data-route-plan","schema_version":"1.0","fetched_at":"2026-07-24T00:00:00.000Z","task":"Inspect recent Base transfers","chain":"base","data_need":"logs","risk_tolerance":"medium","budget_usdc":0.02,"recommended_route":[{"product":"agent-rpc-preflight","path":"/v1/x402/agent/rpc-preflight","price_usdc":"$0.005001","list_price_usdc":"$0.005","reason":"Screen endpoint, method, price, and budget before chain-data access.","stop_if":"Stop or escalate if risk_level is high or flags include critical/high severity."},{"product":"indexed-chain-query-preflight","path":"/v1/x402/chain/indexed-query-preflight","price_usdc":"$0.005008","list_price_usdc":"$0.005","reason":"Check query shape, result size, and schema discovery before indexed-data spend.","stop_if":"Stop or escalate if risk_level is high or flags include critical/high severity."}],"full_route":[{"product":"agent-rpc-preflight","path":"/v1/x402/agent/rpc-preflight","price_usdc":"$0.005001","list_price_usdc":"$0.005","reason":"Screen endpoint, method, price, and budget before chain-data access.","stop_if":"Stop or escalate if risk_level is high or flags include critical/high severity."},{"product":"indexed-chain-query-preflight","path":"/v1/x402/chain/indexed-query-preflight","price_usdc":"$0.005008","list_price_usdc":"$0.005","reason":"Check query shape, result size, and schema discovery before indexed-data spend.","stop_if":"Stop or escalate if risk_level is high or flags include critical/high severity."},{"product":"x402-rpc-payment-guard","path":"/v1/x402/agent/rpc-payment-guard","price_usdc":"$0.100001","list_price_usdc":"$0.10","reason":"Guard the final RPC or indexed-data payment before wallet signing.","stop_if":"Stop or escalate if risk_level is high or flags include critical/high severity."}],"estimated_cost_usdc":0.010009,"stop_conditions":["Endpoint preflight returns BLOCK.","Indexed query estimate exceeds budget or lacks schema discovery."],"escalation":"Budget is too small for the full chain-data route; run the prefix and escalate before paying more.","limitations":["This route plan does not fetch chain data or authorize payment."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/chain/indexed-query-preflight":{"get":{"operationId":"getIndexedChainQueryPreflight","summary":"Indexed Chain Query Preflight","description":"Preflight an indexed chain-data query before payment: schema discovery, query type, estimated rows, cost fit, and safety flags. Price: $0.005008 USDC on Base.","parameters":[{"name":"chain","in":"query","required":true,"schema":{"type":"string","pattern":"^(?=.*[A-Za-z0-9])[A-Za-z0-9:_ -]{2,80}$","description":"Requested chain or CAIP-2 network label.","example":"base"},"example":"base"},{"name":"query_type","in":"query","required":true,"schema":{"type":"string","enum":["schema","event_logs","transfers","balances","transactions","sql","protocol_timeline"],"description":"Indexed data query family.","example":"event_logs"},"example":"event_logs"},{"name":"estimated_rows","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]{1,10}$","description":"Caller-estimated row count or result size.","example":"5000"},"example":"5000"},{"name":"max_price_usdc","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Maximum acceptable query price.","example":"0.02"},"example":"0.02"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"indexed-chain-query-preflight","schema_version":"1.0","fetched_at":"2026-07-24T00:00:00.000Z","chain":"base","query_type":"event_logs","query_context":{"estimated_rows":5000,"max_price_usdc":0.02,"schema_discovery_recommended":true},"assessment":{"decision":"ALLOW","risk_level":"low","risk_score":0,"flags":[],"next_query_shape":"Use explicit chain, address/topic filters, block range, row limit, and price ceiling."},"limitations":["This preflight does not execute SQL or fetch indexed data.","Actual query price and available schema depend on the selected provider route."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/x402/v1/value/convert":{"post":{"operationId":"postNomosValueConvert","summary":"Value Convert","description":"Convert BTC, ETH, TRX, USDT, USDC values into USD or TWD for autonomous-agent budget checks. Price: $0.005012 USDC on Base.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asset":{"type":"string","enum":["BTC","ETH","TRX","USDT","USDC"],"example":"USDT","description":"Asset symbol to convert."},"amount":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,12})?$","example":"100","description":"Positive decimal asset amount with at most 12 fractional digits."},"quote_currency":{"type":"string","enum":["USD","TWD"],"example":"TWD","description":"Quote currency for the converted value."},"idempotency_key":{"type":"string","maxLength":128,"description":"Optional caller-supplied idempotency key."}},"required":["asset","amount","quote_currency"],"example":{"asset":"USDT","amount":"100","quote_currency":"TWD"}},"example":{"asset":"USDT","amount":"100","quote_currency":"TWD"}}}},"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string"},"schema_version":{"type":"string"},"asset":{"type":"string"},"amount":{"type":"string"},"quote_currency":{"type":"string"},"unit_price":{"type":"string"},"converted_value":{"type":"string"},"price_timestamp":{"type":"string"},"data_freshness_seconds":{"type":"integer"},"result_id":{"type":"string"},"source_notes":{"type":"array","items":{"type":"string"}}},"additionalProperties":true,"x-schema-family":"OPERATION_RUNTIME_RESULT","x-schema-authority":"REPRESENTATIVE_RUNTIME_FIXTURE"},"example":{"product":"nomos-value-convert","schema_version":"2.0","asset":"USDT","amount":"100","quote_currency":"TWD","quote_type":"live","unit_price":"32.000000","converted_value":"3200.00","source":"composite_market_quote","provider":"Kraken + fxapi.app","provider_role":"primary","fallback_used":false,"fallback_reason":null,"source_observed_at":"2026-07-24T00:00:00.000Z","response_generated_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0,"market_status":"fresh","sources":[{"leg":"crypto_usd","provider":"Kraken","provider_role":"primary","venue":"Kraken Spot","market":"USDT/USD","pair":"USDTZUSD","value":"1.00000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"recent_trade","timestamp_origin":"exchange_trade_time","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0},{"leg":"usd_twd","provider":"fxapi.app","provider_role":"fx_reference","venue":"FX reference","market":"USD/TWD","pair":"USD/TWD","value":"32.000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"fx_rate","timestamp_origin":"fx_provider_timestamp","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0}],"result_id":"val_20260724000000_example","stablecoin_usd_price":"1.00000000","usd_twd_rate":"32.000000","crypto_source":{"leg":"crypto_usd","provider":"Kraken","provider_role":"primary","venue":"Kraken Spot","market":"USDT/USD","pair":"USDTZUSD","value":"1.00000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"recent_trade","timestamp_origin":"exchange_trade_time","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0},"fx_source":{"leg":"usd_twd","provider":"fxapi.app","provider_role":"fx_reference","venue":"FX reference","market":"USD/TWD","pair":"USD/TWD","value":"32.000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"fx_rate","timestamp_origin":"fx_provider_timestamp","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0},"price_timestamp":"2026-07-24T00:00:00.000Z","data_freshness_seconds":0,"source_notes":["Illustrative offline live-quote response shape; numeric values are synthetic, not current market prices.","Live market quotes carry their original provider observation timestamps."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/x402/v1/value/btc-usd":{"get":{"operationId":"getNomosValueBtcUsd","summary":"Value BTC USD","description":"Return a source-backed live BTC to USD quote for autonomous-agent budget checks. Price: $0.002000 USDC on Base.","parameters":[{"name":"amount","in":"query","required":false,"schema":{"type":"string","pattern":"^(?:[0-9]*[1-9][0-9]*(?:\\.[0-9]{1,12})?|0+\\.(?:[1-9][0-9]{0,11}|0{1}[1-9][0-9]{0,10}|0{2}[1-9][0-9]{0,9}|0{3}[1-9][0-9]{0,8}|0{4}[1-9][0-9]{0,7}|0{5}[1-9][0-9]{0,6}|0{6}[1-9][0-9]{0,5}|0{7}[1-9][0-9]{0,4}|0{8}[1-9][0-9]{0,3}|0{9}[1-9][0-9]{0,2}|0{10}[1-9][0-9]{0,1}|0{11}[1-9]))$","maxLength":64,"description":"Optional positive decimal BTC amount with at most 12 fractional digits. Defaults to 1.","example":"1"},"example":"1"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","const":"nomos-value-btc-usd"},"schema_version":{"type":"string","const":"2.0"},"asset":{"type":"string","const":"BTC"},"amount":{"type":"string","pattern":"^(?:[0-9]*[1-9][0-9]*(?:\\.[0-9]{1,12})?|0+\\.(?:[1-9][0-9]{0,11}|0{1}[1-9][0-9]{0,10}|0{2}[1-9][0-9]{0,9}|0{3}[1-9][0-9]{0,8}|0{4}[1-9][0-9]{0,7}|0{5}[1-9][0-9]{0,6}|0{6}[1-9][0-9]{0,5}|0{7}[1-9][0-9]{0,4}|0{8}[1-9][0-9]{0,3}|0{9}[1-9][0-9]{0,2}|0{10}[1-9][0-9]{0,1}|0{11}[1-9]))$"},"quote_currency":{"type":"string","const":"USD"},"quote_type":{"type":"string","const":"live"},"unit_price":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"converted_value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"source":{"type":"string","const":"live_market_quote"},"provider":{"type":"string","enum":["Kraken","Bitfinex"]},"provider_role":{"type":"string","enum":["primary","fallback"]},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":["string","null"],"enum":[null,"primary_timeout","primary_http_error","primary_network_error","primary_invalid_payload","primary_stale"]},"source_observed_at":{"type":"string","format":"date-time"},"response_generated_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0},"market_status":{"type":"string","const":"fresh"},"sources":{"type":"array","minItems":1,"maxItems":1,"items":{"type":"object","properties":{"leg":{"type":"string","const":"crypto_usd"},"provider":{"type":"string","enum":["Kraken","Bitfinex"]},"provider_role":{"type":"string","enum":["primary","fallback"]},"venue":{"type":"string"},"market":{"type":"string"},"pair":{"type":"string"},"value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"observed_at":{"type":"string","format":"date-time"},"observation_type":{"type":"string","enum":["recent_trade","ticker_snapshot"]},"timestamp_origin":{"type":"string","enum":["exchange_trade_time","fetch_completion_time"]},"fetched_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0,"maximum":180}},"required":["leg","provider","provider_role","venue","market","pair","value","observed_at","observation_type","timestamp_origin","fetched_at","freshness_seconds"],"additionalProperties":false}},"result_id":{"type":"string","pattern":"^val_[0-9]{14}_[0-9a-z]+$"}},"required":["product","schema_version","asset","amount","quote_currency","quote_type","unit_price","converted_value","source","provider","provider_role","fallback_used","fallback_reason","source_observed_at","response_generated_at","freshness_seconds","market_status","sources","result_id"],"additionalProperties":false,"x-schema-family":"FX_LIVE_QUOTE_V2","x-schema-authority":"SHARED_FX_LIVE_QUOTE_CONTRACT"},"example":{"product":"nomos-value-btc-usd","schema_version":"2.0","asset":"BTC","amount":"1","quote_currency":"USD","quote_type":"live","unit_price":"1.000000","converted_value":"1.00","source":"live_market_quote","provider":"Kraken","provider_role":"primary","fallback_used":false,"fallback_reason":null,"source_observed_at":"2026-07-24T00:00:00.000Z","response_generated_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0,"market_status":"fresh","sources":[{"leg":"crypto_usd","provider":"Kraken","provider_role":"primary","venue":"Kraken Spot","market":"BTC/USD","pair":"XXBTZUSD","value":"1.00000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"recent_trade","timestamp_origin":"exchange_trade_time","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0}],"result_id":"val_20260724000000_bgp"}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/x402/v1/value/eth-usd":{"get":{"operationId":"getNomosValueEthUsd","summary":"Value ETH USD","description":"Return a source-backed live ETH to USD quote for autonomous-agent budget checks. Price: $0.002001 USDC on Base.","parameters":[{"name":"amount","in":"query","required":false,"schema":{"type":"string","pattern":"^(?:[0-9]*[1-9][0-9]*(?:\\.[0-9]{1,12})?|0+\\.(?:[1-9][0-9]{0,11}|0{1}[1-9][0-9]{0,10}|0{2}[1-9][0-9]{0,9}|0{3}[1-9][0-9]{0,8}|0{4}[1-9][0-9]{0,7}|0{5}[1-9][0-9]{0,6}|0{6}[1-9][0-9]{0,5}|0{7}[1-9][0-9]{0,4}|0{8}[1-9][0-9]{0,3}|0{9}[1-9][0-9]{0,2}|0{10}[1-9][0-9]{0,1}|0{11}[1-9]))$","maxLength":64,"description":"Optional positive decimal ETH amount with at most 12 fractional digits. Defaults to 1.","example":"1"},"example":"1"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","const":"nomos-value-eth-usd"},"schema_version":{"type":"string","const":"2.0"},"asset":{"type":"string","const":"ETH"},"amount":{"type":"string","pattern":"^(?:[0-9]*[1-9][0-9]*(?:\\.[0-9]{1,12})?|0+\\.(?:[1-9][0-9]{0,11}|0{1}[1-9][0-9]{0,10}|0{2}[1-9][0-9]{0,9}|0{3}[1-9][0-9]{0,8}|0{4}[1-9][0-9]{0,7}|0{5}[1-9][0-9]{0,6}|0{6}[1-9][0-9]{0,5}|0{7}[1-9][0-9]{0,4}|0{8}[1-9][0-9]{0,3}|0{9}[1-9][0-9]{0,2}|0{10}[1-9][0-9]{0,1}|0{11}[1-9]))$"},"quote_currency":{"type":"string","const":"USD"},"quote_type":{"type":"string","const":"live"},"unit_price":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"converted_value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"source":{"type":"string","const":"live_market_quote"},"provider":{"type":"string","enum":["Kraken","Bitfinex"]},"provider_role":{"type":"string","enum":["primary","fallback"]},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":["string","null"],"enum":[null,"primary_timeout","primary_http_error","primary_network_error","primary_invalid_payload","primary_stale"]},"source_observed_at":{"type":"string","format":"date-time"},"response_generated_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0},"market_status":{"type":"string","const":"fresh"},"sources":{"type":"array","minItems":1,"maxItems":1,"items":{"type":"object","properties":{"leg":{"type":"string","const":"crypto_usd"},"provider":{"type":"string","enum":["Kraken","Bitfinex"]},"provider_role":{"type":"string","enum":["primary","fallback"]},"venue":{"type":"string"},"market":{"type":"string"},"pair":{"type":"string"},"value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"observed_at":{"type":"string","format":"date-time"},"observation_type":{"type":"string","enum":["recent_trade","ticker_snapshot"]},"timestamp_origin":{"type":"string","enum":["exchange_trade_time","fetch_completion_time"]},"fetched_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0,"maximum":180}},"required":["leg","provider","provider_role","venue","market","pair","value","observed_at","observation_type","timestamp_origin","fetched_at","freshness_seconds"],"additionalProperties":false}},"result_id":{"type":"string","pattern":"^val_[0-9]{14}_[0-9a-z]+$"}},"required":["product","schema_version","asset","amount","quote_currency","quote_type","unit_price","converted_value","source","provider","provider_role","fallback_used","fallback_reason","source_observed_at","response_generated_at","freshness_seconds","market_status","sources","result_id"],"additionalProperties":false,"x-schema-family":"FX_LIVE_QUOTE_V2","x-schema-authority":"SHARED_FX_LIVE_QUOTE_CONTRACT"},"example":{"product":"nomos-value-eth-usd","schema_version":"2.0","asset":"ETH","amount":"1","quote_currency":"USD","quote_type":"live","unit_price":"1.000000","converted_value":"1.00","source":"live_market_quote","provider":"Kraken","provider_role":"primary","fallback_used":false,"fallback_reason":null,"source_observed_at":"2026-07-24T00:00:00.000Z","response_generated_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0,"market_status":"fresh","sources":[{"leg":"crypto_usd","provider":"Kraken","provider_role":"primary","venue":"Kraken Spot","market":"ETH/USD","pair":"XETHZUSD","value":"1.00000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"recent_trade","timestamp_origin":"exchange_trade_time","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0}],"result_id":"val_20260724000000_bgx"}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/x402/v1/value/trx-usd":{"get":{"operationId":"getNomosValueTrxUsd","summary":"Value TRX USD","description":"Return a source-backed live TRX to USD quote for autonomous-agent budget checks. Price: $0.001000 USDC on Base.","parameters":[{"name":"amount","in":"query","required":false,"schema":{"type":"string","pattern":"^(?:[0-9]*[1-9][0-9]*(?:\\.[0-9]{1,12})?|0+\\.(?:[1-9][0-9]{0,11}|0{1}[1-9][0-9]{0,10}|0{2}[1-9][0-9]{0,9}|0{3}[1-9][0-9]{0,8}|0{4}[1-9][0-9]{0,7}|0{5}[1-9][0-9]{0,6}|0{6}[1-9][0-9]{0,5}|0{7}[1-9][0-9]{0,4}|0{8}[1-9][0-9]{0,3}|0{9}[1-9][0-9]{0,2}|0{10}[1-9][0-9]{0,1}|0{11}[1-9]))$","maxLength":64,"description":"Optional positive decimal TRX amount with at most 12 fractional digits. Defaults to 1.","example":"1"},"example":"1"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","const":"nomos-value-trx-usd"},"schema_version":{"type":"string","const":"2.0"},"asset":{"type":"string","const":"TRX"},"amount":{"type":"string","pattern":"^(?:[0-9]*[1-9][0-9]*(?:\\.[0-9]{1,12})?|0+\\.(?:[1-9][0-9]{0,11}|0{1}[1-9][0-9]{0,10}|0{2}[1-9][0-9]{0,9}|0{3}[1-9][0-9]{0,8}|0{4}[1-9][0-9]{0,7}|0{5}[1-9][0-9]{0,6}|0{6}[1-9][0-9]{0,5}|0{7}[1-9][0-9]{0,4}|0{8}[1-9][0-9]{0,3}|0{9}[1-9][0-9]{0,2}|0{10}[1-9][0-9]{0,1}|0{11}[1-9]))$"},"quote_currency":{"type":"string","const":"USD"},"quote_type":{"type":"string","const":"live"},"unit_price":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"converted_value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"source":{"type":"string","const":"live_market_quote"},"provider":{"type":"string","enum":["Kraken","Bitfinex"]},"provider_role":{"type":"string","enum":["primary","fallback"]},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":["string","null"],"enum":[null,"primary_timeout","primary_http_error","primary_network_error","primary_invalid_payload","primary_stale"]},"source_observed_at":{"type":"string","format":"date-time"},"response_generated_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0},"market_status":{"type":"string","const":"fresh"},"sources":{"type":"array","minItems":1,"maxItems":1,"items":{"type":"object","properties":{"leg":{"type":"string","const":"crypto_usd"},"provider":{"type":"string","enum":["Kraken","Bitfinex"]},"provider_role":{"type":"string","enum":["primary","fallback"]},"venue":{"type":"string"},"market":{"type":"string"},"pair":{"type":"string"},"value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"observed_at":{"type":"string","format":"date-time"},"observation_type":{"type":"string","enum":["recent_trade","ticker_snapshot"]},"timestamp_origin":{"type":"string","enum":["exchange_trade_time","fetch_completion_time"]},"fetched_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0,"maximum":180}},"required":["leg","provider","provider_role","venue","market","pair","value","observed_at","observation_type","timestamp_origin","fetched_at","freshness_seconds"],"additionalProperties":false}},"result_id":{"type":"string","pattern":"^val_[0-9]{14}_[0-9a-z]+$"}},"required":["product","schema_version","asset","amount","quote_currency","quote_type","unit_price","converted_value","source","provider","provider_role","fallback_used","fallback_reason","source_observed_at","response_generated_at","freshness_seconds","market_status","sources","result_id"],"additionalProperties":false,"x-schema-family":"FX_LIVE_QUOTE_V2","x-schema-authority":"SHARED_FX_LIVE_QUOTE_CONTRACT"},"example":{"product":"nomos-value-trx-usd","schema_version":"2.0","asset":"TRX","amount":"1","quote_currency":"USD","quote_type":"live","unit_price":"1.000000","converted_value":"1.00","source":"live_market_quote","provider":"Kraken","provider_role":"primary","fallback_used":false,"fallback_reason":null,"source_observed_at":"2026-07-24T00:00:00.000Z","response_generated_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0,"market_status":"fresh","sources":[{"leg":"crypto_usd","provider":"Kraken","provider_role":"primary","venue":"Kraken Spot","market":"TRX/USD","pair":"TRXUSD","value":"1.00000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"recent_trade","timestamp_origin":"exchange_trade_time","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0}],"result_id":"val_20260724000000_bhq"}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/x402/v1/value/usdt-twd":{"get":{"operationId":"getNomosValueUsdtTwd","summary":"Value USDT TWD","description":"Return a source-backed live USDT to TWD composite quote for autonomous-agent budget checks. Price: $0.001002 USDC on Base.","parameters":[{"name":"amount","in":"query","required":false,"schema":{"type":"string","pattern":"^(?:[0-9]*[1-9][0-9]*(?:\\.[0-9]{1,12})?|0+\\.(?:[1-9][0-9]{0,11}|0{1}[1-9][0-9]{0,10}|0{2}[1-9][0-9]{0,9}|0{3}[1-9][0-9]{0,8}|0{4}[1-9][0-9]{0,7}|0{5}[1-9][0-9]{0,6}|0{6}[1-9][0-9]{0,5}|0{7}[1-9][0-9]{0,4}|0{8}[1-9][0-9]{0,3}|0{9}[1-9][0-9]{0,2}|0{10}[1-9][0-9]{0,1}|0{11}[1-9]))$","maxLength":64,"description":"Optional positive decimal USDT amount with at most 12 fractional digits. Defaults to 1.","example":"1"},"example":"1"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","const":"nomos-value-usdt-twd"},"schema_version":{"type":"string","const":"2.0"},"asset":{"type":"string","const":"USDT"},"amount":{"type":"string","pattern":"^(?:[0-9]*[1-9][0-9]*(?:\\.[0-9]{1,12})?|0+\\.(?:[1-9][0-9]{0,11}|0{1}[1-9][0-9]{0,10}|0{2}[1-9][0-9]{0,9}|0{3}[1-9][0-9]{0,8}|0{4}[1-9][0-9]{0,7}|0{5}[1-9][0-9]{0,6}|0{6}[1-9][0-9]{0,5}|0{7}[1-9][0-9]{0,4}|0{8}[1-9][0-9]{0,3}|0{9}[1-9][0-9]{0,2}|0{10}[1-9][0-9]{0,1}|0{11}[1-9]))$"},"quote_currency":{"type":"string","const":"TWD"},"quote_type":{"type":"string","const":"live"},"unit_price":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"converted_value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"source":{"type":"string","const":"composite_market_quote"},"provider":{"type":"string","enum":["Kraken + fxapi.app","Bitfinex + fxapi.app"]},"provider_role":{"type":"string","enum":["primary","fallback"]},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":["string","null"],"enum":[null,"primary_timeout","primary_http_error","primary_network_error","primary_invalid_payload","primary_stale"]},"source_observed_at":{"type":"string","format":"date-time"},"response_generated_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0},"market_status":{"type":"string","const":"fresh"},"sources":{"type":"array","minItems":2,"maxItems":2,"items":{"oneOf":[{"type":"object","properties":{"leg":{"type":"string","const":"crypto_usd"},"provider":{"type":"string","enum":["Kraken","Bitfinex"]},"provider_role":{"type":"string","enum":["primary","fallback"]},"venue":{"type":"string"},"market":{"type":"string"},"pair":{"type":"string"},"value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"observed_at":{"type":"string","format":"date-time"},"observation_type":{"type":"string","enum":["recent_trade","ticker_snapshot"]},"timestamp_origin":{"type":"string","enum":["exchange_trade_time","fetch_completion_time"]},"fetched_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0,"maximum":180}},"required":["leg","provider","provider_role","venue","market","pair","value","observed_at","observation_type","timestamp_origin","fetched_at","freshness_seconds"],"additionalProperties":false},{"type":"object","properties":{"leg":{"type":"string","const":"usd_twd"},"provider":{"type":"string","const":"fxapi.app"},"provider_role":{"type":"string","const":"fx_reference"},"venue":{"type":"string"},"market":{"type":"string"},"pair":{"type":"string"},"value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"observed_at":{"type":"string","format":"date-time"},"observation_type":{"type":"string","const":"fx_rate"},"timestamp_origin":{"type":"string","const":"fx_provider_timestamp"},"fetched_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0,"maximum":600}},"required":["leg","provider","provider_role","venue","market","pair","value","observed_at","observation_type","timestamp_origin","fetched_at","freshness_seconds"],"additionalProperties":false}]}},"result_id":{"type":"string","pattern":"^val_[0-9]{14}_[0-9a-z]+$"},"stablecoin_usd_price":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"usd_twd_rate":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"crypto_source":{"type":"object","properties":{"leg":{"type":"string","const":"crypto_usd"},"provider":{"type":"string","enum":["Kraken","Bitfinex"]},"provider_role":{"type":"string","enum":["primary","fallback"]},"venue":{"type":"string"},"market":{"type":"string"},"pair":{"type":"string"},"value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"observed_at":{"type":"string","format":"date-time"},"observation_type":{"type":"string","enum":["recent_trade","ticker_snapshot"]},"timestamp_origin":{"type":"string","enum":["exchange_trade_time","fetch_completion_time"]},"fetched_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0,"maximum":180}},"required":["leg","provider","provider_role","venue","market","pair","value","observed_at","observation_type","timestamp_origin","fetched_at","freshness_seconds"],"additionalProperties":false},"fx_source":{"type":"object","properties":{"leg":{"type":"string","const":"usd_twd"},"provider":{"type":"string","const":"fxapi.app"},"provider_role":{"type":"string","const":"fx_reference"},"venue":{"type":"string"},"market":{"type":"string"},"pair":{"type":"string"},"value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"observed_at":{"type":"string","format":"date-time"},"observation_type":{"type":"string","const":"fx_rate"},"timestamp_origin":{"type":"string","const":"fx_provider_timestamp"},"fetched_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0,"maximum":600}},"required":["leg","provider","provider_role","venue","market","pair","value","observed_at","observation_type","timestamp_origin","fetched_at","freshness_seconds"],"additionalProperties":false}},"required":["product","schema_version","asset","amount","quote_currency","quote_type","unit_price","converted_value","source","provider","provider_role","fallback_used","fallback_reason","source_observed_at","response_generated_at","freshness_seconds","market_status","sources","result_id","stablecoin_usd_price","usd_twd_rate","crypto_source","fx_source"],"additionalProperties":false,"x-schema-family":"FX_LIVE_QUOTE_V2","x-schema-authority":"SHARED_FX_LIVE_QUOTE_CONTRACT"},"example":{"product":"nomos-value-usdt-twd","schema_version":"2.0","asset":"USDT","amount":"1","quote_currency":"TWD","quote_type":"live","unit_price":"1.000000","converted_value":"1.00","source":"composite_market_quote","provider":"Kraken + fxapi.app","provider_role":"primary","fallback_used":false,"fallback_reason":null,"source_observed_at":"2026-07-24T00:00:00.000Z","response_generated_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0,"market_status":"fresh","sources":[{"leg":"crypto_usd","provider":"Kraken","provider_role":"primary","venue":"Kraken Spot","market":"USDT/USD","pair":"USDTZUSD","value":"1.00000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"recent_trade","timestamp_origin":"exchange_trade_time","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0},{"leg":"usd_twd","provider":"fxapi.app","provider_role":"fx_reference","venue":"FX reference","market":"USD/TWD","pair":"USD/TWD","value":"1.000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"fx_rate","timestamp_origin":"fx_provider_timestamp","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0}],"result_id":"val_20260724000000_bjv","stablecoin_usd_price":"1.00000000","usd_twd_rate":"1.000000","crypto_source":{"leg":"crypto_usd","provider":"Kraken","provider_role":"primary","venue":"Kraken Spot","market":"USDT/USD","pair":"USDTZUSD","value":"1.00000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"recent_trade","timestamp_origin":"exchange_trade_time","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0},"fx_source":{"leg":"usd_twd","provider":"fxapi.app","provider_role":"fx_reference","venue":"FX reference","market":"USD/TWD","pair":"USD/TWD","value":"1.000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"fx_rate","timestamp_origin":"fx_provider_timestamp","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0}}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/x402/v1/value/usdc-twd":{"get":{"operationId":"getNomosValueUsdcTwd","summary":"Value USDC TWD","description":"Return a source-backed live USDC to TWD composite quote for autonomous-agent budget checks. Price: $0.001001 USDC on Base.","parameters":[{"name":"amount","in":"query","required":false,"schema":{"type":"string","pattern":"^(?:[0-9]*[1-9][0-9]*(?:\\.[0-9]{1,12})?|0+\\.(?:[1-9][0-9]{0,11}|0{1}[1-9][0-9]{0,10}|0{2}[1-9][0-9]{0,9}|0{3}[1-9][0-9]{0,8}|0{4}[1-9][0-9]{0,7}|0{5}[1-9][0-9]{0,6}|0{6}[1-9][0-9]{0,5}|0{7}[1-9][0-9]{0,4}|0{8}[1-9][0-9]{0,3}|0{9}[1-9][0-9]{0,2}|0{10}[1-9][0-9]{0,1}|0{11}[1-9]))$","maxLength":64,"description":"Optional positive decimal USDC amount with at most 12 fractional digits. Defaults to 1.","example":"1"},"example":"1"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string","const":"nomos-value-usdc-twd"},"schema_version":{"type":"string","const":"2.0"},"asset":{"type":"string","const":"USDC"},"amount":{"type":"string","pattern":"^(?:[0-9]*[1-9][0-9]*(?:\\.[0-9]{1,12})?|0+\\.(?:[1-9][0-9]{0,11}|0{1}[1-9][0-9]{0,10}|0{2}[1-9][0-9]{0,9}|0{3}[1-9][0-9]{0,8}|0{4}[1-9][0-9]{0,7}|0{5}[1-9][0-9]{0,6}|0{6}[1-9][0-9]{0,5}|0{7}[1-9][0-9]{0,4}|0{8}[1-9][0-9]{0,3}|0{9}[1-9][0-9]{0,2}|0{10}[1-9][0-9]{0,1}|0{11}[1-9]))$"},"quote_currency":{"type":"string","const":"TWD"},"quote_type":{"type":"string","const":"live"},"unit_price":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"converted_value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"source":{"type":"string","const":"composite_market_quote"},"provider":{"type":"string","enum":["Kraken + fxapi.app","Bitfinex + fxapi.app"]},"provider_role":{"type":"string","enum":["primary","fallback"]},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":["string","null"],"enum":[null,"primary_timeout","primary_http_error","primary_network_error","primary_invalid_payload","primary_stale"]},"source_observed_at":{"type":"string","format":"date-time"},"response_generated_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0},"market_status":{"type":"string","const":"fresh"},"sources":{"type":"array","minItems":2,"maxItems":2,"items":{"oneOf":[{"type":"object","properties":{"leg":{"type":"string","const":"crypto_usd"},"provider":{"type":"string","enum":["Kraken","Bitfinex"]},"provider_role":{"type":"string","enum":["primary","fallback"]},"venue":{"type":"string"},"market":{"type":"string"},"pair":{"type":"string"},"value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"observed_at":{"type":"string","format":"date-time"},"observation_type":{"type":"string","enum":["recent_trade","ticker_snapshot"]},"timestamp_origin":{"type":"string","enum":["exchange_trade_time","fetch_completion_time"]},"fetched_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0,"maximum":180}},"required":["leg","provider","provider_role","venue","market","pair","value","observed_at","observation_type","timestamp_origin","fetched_at","freshness_seconds"],"additionalProperties":false},{"type":"object","properties":{"leg":{"type":"string","const":"usd_twd"},"provider":{"type":"string","const":"fxapi.app"},"provider_role":{"type":"string","const":"fx_reference"},"venue":{"type":"string"},"market":{"type":"string"},"pair":{"type":"string"},"value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"observed_at":{"type":"string","format":"date-time"},"observation_type":{"type":"string","const":"fx_rate"},"timestamp_origin":{"type":"string","const":"fx_provider_timestamp"},"fetched_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0,"maximum":600}},"required":["leg","provider","provider_role","venue","market","pair","value","observed_at","observation_type","timestamp_origin","fetched_at","freshness_seconds"],"additionalProperties":false}]}},"result_id":{"type":"string","pattern":"^val_[0-9]{14}_[0-9a-z]+$"},"stablecoin_usd_price":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"usd_twd_rate":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"crypto_source":{"type":"object","properties":{"leg":{"type":"string","const":"crypto_usd"},"provider":{"type":"string","enum":["Kraken","Bitfinex"]},"provider_role":{"type":"string","enum":["primary","fallback"]},"venue":{"type":"string"},"market":{"type":"string"},"pair":{"type":"string"},"value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"observed_at":{"type":"string","format":"date-time"},"observation_type":{"type":"string","enum":["recent_trade","ticker_snapshot"]},"timestamp_origin":{"type":"string","enum":["exchange_trade_time","fetch_completion_time"]},"fetched_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0,"maximum":180}},"required":["leg","provider","provider_role","venue","market","pair","value","observed_at","observation_type","timestamp_origin","fetched_at","freshness_seconds"],"additionalProperties":false},"fx_source":{"type":"object","properties":{"leg":{"type":"string","const":"usd_twd"},"provider":{"type":"string","const":"fxapi.app"},"provider_role":{"type":"string","const":"fx_reference"},"venue":{"type":"string"},"market":{"type":"string"},"pair":{"type":"string"},"value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"observed_at":{"type":"string","format":"date-time"},"observation_type":{"type":"string","const":"fx_rate"},"timestamp_origin":{"type":"string","const":"fx_provider_timestamp"},"fetched_at":{"type":"string","format":"date-time"},"freshness_seconds":{"type":"integer","minimum":0,"maximum":600}},"required":["leg","provider","provider_role","venue","market","pair","value","observed_at","observation_type","timestamp_origin","fetched_at","freshness_seconds"],"additionalProperties":false},"usdc_usd_price":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"}},"required":["product","schema_version","asset","amount","quote_currency","quote_type","unit_price","converted_value","source","provider","provider_role","fallback_used","fallback_reason","source_observed_at","response_generated_at","freshness_seconds","market_status","sources","result_id","stablecoin_usd_price","usd_twd_rate","crypto_source","fx_source","usdc_usd_price"],"additionalProperties":false,"x-schema-family":"FX_LIVE_QUOTE_V2","x-schema-authority":"SHARED_FX_LIVE_QUOTE_CONTRACT"},"example":{"product":"nomos-value-usdc-twd","schema_version":"2.0","asset":"USDC","amount":"1","quote_currency":"TWD","quote_type":"live","unit_price":"1.000000","converted_value":"1.00","source":"composite_market_quote","provider":"Kraken + fxapi.app","provider_role":"primary","fallback_used":false,"fallback_reason":null,"source_observed_at":"2026-07-24T00:00:00.000Z","response_generated_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0,"market_status":"fresh","sources":[{"leg":"crypto_usd","provider":"Kraken","provider_role":"primary","venue":"Kraken Spot","market":"USDC/USD","pair":"USDCUSD","value":"1.00000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"recent_trade","timestamp_origin":"exchange_trade_time","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0},{"leg":"usd_twd","provider":"fxapi.app","provider_role":"fx_reference","venue":"FX reference","market":"USD/TWD","pair":"USD/TWD","value":"1.000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"fx_rate","timestamp_origin":"fx_provider_timestamp","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0}],"result_id":"val_20260724000000_bje","stablecoin_usd_price":"1.00000000","usd_twd_rate":"1.000000","crypto_source":{"leg":"crypto_usd","provider":"Kraken","provider_role":"primary","venue":"Kraken Spot","market":"USDC/USD","pair":"USDCUSD","value":"1.00000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"recent_trade","timestamp_origin":"exchange_trade_time","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0},"fx_source":{"leg":"usd_twd","provider":"fxapi.app","provider_role":"fx_reference","venue":"FX reference","market":"USD/TWD","pair":"USD/TWD","value":"1.000000","observed_at":"2026-07-24T00:00:00.000Z","observation_type":"fx_rate","timestamp_origin":"fx_provider_timestamp","fetched_at":"2026-07-24T00:00:00.000Z","freshness_seconds":0},"usdc_usd_price":"1.00000000"}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/agent/action-preflight":{"get":{"operationId":"getAgentActionPreflight","summary":"Agent Action Preflight","description":"Return an advisory AgentOps Guard REVIEW/BLOCK result (never ALLOW; not an authorization) before a side-effecting agent action runs. Price: $0.010000 USDC on Base.","parameters":[{"name":"action_type","in":"query","required":true,"schema":{"type":"string","enum":["tool_call","shell","deploy","dns","email","mcp_call","wallet","x402_purchase","file_write","browser"],"description":"Side-effecting action the agent wants to run.","example":"deploy"},"example":"deploy"},{"name":"target","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"description":"Human-readable target, command, endpoint, domain, or resource.","example":"production worker"},"example":"production worker"},{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,128}$","description":"Caller-defined agent or principal id.","example":"demo-agent"},"example":"demo-agent"},{"name":"environment","in":"query","required":false,"schema":{"type":"string","enum":["local","dev","staging","production","external"],"description":"Execution environment for the action.","example":"production"},"example":"production"},{"name":"risk_score","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]{1,3}$","description":"Optional caller-supplied 0-100 risk score.","example":"35"},"example":"35"},{"name":"amount_usdc","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Optional payment, spend, or value at risk.","example":"0.00"},"example":"0.00"},{"name":"human_approval_ref","in":"query","required":false,"schema":{"type":"string","maxLength":160,"description":"Human approval or ticket reference for elevated actions."}}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string"},"schema_version":{"type":"string"},"decision":{"type":"string"},"decision_vocabulary":{"type":"string"},"normalized_decision":{"type":"string"},"decision_id":{"type":"string"},"policy_version":{"type":"string"},"pricing_version":{"type":"string"},"action":{"type":"object","properties":{"type":{"type":"string"},"target":{"type":"string"},"agent_id":{"type":"string"},"environment":{"type":"string"},"amount_usdc":{"type":"integer"}},"additionalProperties":true},"assessment":{"type":"object","properties":{"risk_score":{"type":"integer"},"risk_level":{"type":"string"},"reason_codes":{"type":"array","items":{"type":"string"}},"reasons":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"severity":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true},"directive":{"type":"object","properties":{"proceed":{"type":"boolean"},"require_human_review":{"type":"boolean"},"block_execution":{"type":"boolean"},"required_evidence":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"authorization":{"type":"object","properties":{"is_authorization_decision":{"type":"boolean"},"inputs_verified":{"type":"boolean"},"mode":{"type":"string"},"ignored_caller_assertions":{"type":"array","items":{"type":"string"}},"unverified_caller_assertions":{"type":"array","items":{"type":"string"}},"note":{"type":"string"}},"additionalProperties":true},"generated_at":{"type":"string"},"expires_at":{"type":"string"},"decision_nonce":{"type":"string","pattern":"^[a-f0-9]{32}$","description":"Single-use nonce bound into the signed receipt; consume once via POST /v1/agentic-commerce/preflight/consume."},"receipt_status":{"type":"string","enum":["SIGNED","SIGNING_KEY_UNAVAILABLE","SIGNING_KEY_MALFORMED","SIGNING_FAILED"],"description":"SIGNED, or a fail-closed reason (receipt is null): key missing, key malformed, or signing failed."},"receipt_error":{"type":["string","null"],"enum":[null,"receipt_signing_key_missing","receipt_signing_key_malformed","receipt_signing_failed"]},"receipt":{"type":["object","null"],"additionalProperties":true,"description":"Preflight decision receipt signed with the separate preflight key (key_id nomos-preflight-receipt-key-v1; signed receipt_purpose=preflight_decision, product, decision_nonce; TTL <= 300s). Null when NOMOS_PREFLIGHT_RECEIPT_SIGNING_JWK is not configured. Advisory; never an ALLOW authorization."},"replay_protection":{"type":"object","additionalProperties":true},"consume_token":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$","description":"One-time ownership secret for the consume route; only its SHA-256 is signed. Treat as a secret."}},"additionalProperties":true,"x-schema-family":"OPERATION_RUNTIME_RESULT","x-schema-authority":"REPRESENTATIVE_RUNTIME_FIXTURE"},"example":{"product":"agent-action-preflight","schema_version":"1.0","decision":"REVIEW","decision_vocabulary":"ALLOW_REVIEW_BLOCK","normalized_decision":"REQUIRE_APPROVAL","decision_id":"act_20260724000000_9pk","policy_version":"agentops-action-preflight-v1","pricing_version":"x402-pricing-v2-resource-binding-20260910","action":{"type":"deploy","target":"production worker","agent_id":"demo-agent","environment":"production","amount_usdc":0},"assessment":{"risk_score":60,"risk_level":"medium","reason_codes":["HIGH_IMPACT_ACTION","EXTERNAL_OR_PRODUCTION_TARGET","HUMAN_APPROVAL_MISSING"],"reasons":[{"code":"HIGH_IMPACT_ACTION","severity":"medium","detail":"deploy can create external side effects and should be gated."},{"code":"EXTERNAL_OR_PRODUCTION_TARGET","severity":"medium","detail":"The action targets production or an external system."},{"code":"HUMAN_APPROVAL_MISSING","severity":"medium","detail":"Elevated actions should carry a human approval or ticket reference."}]},"directive":{"proceed":false,"require_human_review":true,"block_execution":false,"required_evidence":["human_approval_ref","idempotency_key","execution_log_destination","rollback_or_recovery_plan"]},"authorization":{"is_authorization_decision":false,"inputs_verified":false,"mode":"advisory","ignored_caller_assertions":["human_approval_ref"],"unverified_caller_assertions":["action_type","target","environment","amount_usdc","risk_score"],"note":"Advisory heuristic only. Principal, mandate, KYT, approval reference and risk inputs are caller asserted and NOT verified. This response is not an authorization decision and never returns a usable ALLOW."},"generated_at":"2026-07-24T00:00:00.000Z","expires_at":"2026-07-24T00:05:00.000Z"}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/agent/mcp-server-risk-check":{"get":{"operationId":"getMcpServerRiskCheck","summary":"Mcp Server Risk Check","description":"Assess caller-declared MCP tools, authentication and transport for side-effect risks. Advisory report only; it does not connect to or enforce permissions on the server. Price: $0.020001 USDC on Base.","parameters":[{"name":"server_url","in":"query","required":false,"schema":{"type":"string","pattern":"^https?://","maxLength":2048,"description":"Public MCP server, manifest, or connector URL.","example":"https://example.com/mcp"},"example":"https://example.com/mcp"},{"name":"tools","in":"query","required":false,"schema":{"type":"string","maxLength":2000,"description":"Comma-separated MCP tool names when a manifest URL is unavailable.","example":"read_file,write_file,send_email"},"example":"read_file,write_file,send_email"},{"name":"auth","in":"query","required":false,"schema":{"type":"string","enum":["none","api_key","bearer","oauth","mTLS","unknown"],"description":"Authentication mode exposed by the MCP server.","example":"bearer"},"example":"bearer"},{"name":"transport","in":"query","required":false,"schema":{"type":"string","enum":["stdio","http","sse","websocket","unknown"],"description":"MCP transport mode.","example":"http"},"example":"http"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string"},"schema_version":{"type":"string"},"decision":{"type":"string"},"policy_version":{"type":"string"},"pricing_version":{"type":"string"},"server":{"type":"object","properties":{"url":{"type":"string"},"auth":{"type":"string"},"transport":{"type":"string"},"tool_count":{"type":"integer"},"side_effect_tool_count":{"type":"integer"}},"additionalProperties":true},"assessment":{"type":"object","properties":{"risk_score":{"type":"integer"},"risk_level":{"type":"string"},"reason_codes":{"type":"array","items":{"type":"string"}},"reasons":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"severity":{"type":"string"},"detail":{"type":"string"}},"additionalProperties":true}},"side_effect_tools":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"connection_guidance":{"type":"string"},"generated_at":{"type":"string"}},"additionalProperties":true,"x-schema-family":"OPERATION_RUNTIME_RESULT","x-schema-authority":"REPRESENTATIVE_RUNTIME_FIXTURE"},"example":{"product":"mcp-server-risk-check","schema_version":"1.0","decision":"ALLOW","policy_version":"agentops-mcp-risk-v1","pricing_version":"x402-pricing-v2-resource-binding-20260910","server":{"url":"https://example.com/mcp","auth":"bearer","transport":"http","tool_count":3,"side_effect_tool_count":2},"assessment":{"risk_score":24,"risk_level":"low","reason_codes":["SIDE_EFFECT_TOOLS_EXPOSED"],"reasons":[{"code":"SIDE_EFFECT_TOOLS_EXPOSED","severity":"medium","detail":"Side-effecting tools detected: write_file, send_email."}],"side_effect_tools":["write_file","send_email"]},"connection_guidance":"Connect with normal runtime limits and log tool calls.","generated_at":"2026-11-01T00:00:00.000Z"}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/software/github-repository-health":{"get":{"operationId":"getGithubRepositoryHealth","summary":"Github Repository Health","description":"Inspect public GitHub repository maintenance, license and release metadata. Advisory evidence only; it does not certify code security or require a GitHub account. Price: $0.020004 USDC on Base.","parameters":[{"name":"owner","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$","description":"GitHub repository owner or organization.","example":"cloudflare"},"example":"cloudflare"},{"name":"repo","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,100}$","description":"Public GitHub repository name.","example":"workers-sdk"},"example":"workers-sdk"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"github-repository-health","schema_version":"1.0","repository":"cloudflare/workers-sdk","fetched_at":"2026-11-01T00:00:00.000Z","assessment":{"risk_level":"low","risk_score":0,"flags":[]},"health":{"archived":false,"disabled":false,"fork":false,"visibility":"public","pushed_at":"2026-11-01T00:00:00.000Z","stale_days":0,"created_at":"2020-01-01T00:00:00.000Z","default_branch":"main","license":"MIT","stars":100,"forks":20,"watchers":10,"open_issues":3,"size_kb":1000,"topics":["cloudflare-workers"],"latest_release":null},"provenance":{"provider":"GitHub REST API","repository_url":"https://github.com/cloudflare/workers-sdk"},"limitations":["Popularity and recent commits do not prove code quality or security.","Open issue counts can include pull requests and vary by project workflow."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/x402/v1/policy/budget-check":{"post":{"operationId":"postNomosBudgetCheck","summary":"Nomos Budget Check","description":"Compare caller-supplied requested spend with supplied budget and transaction limits. Advisory policy calculation only; it does not reserve funds, enforce a wallet limit or authorize payment. Price: $0.020005 USDC on Base.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agent_id":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,128}$","example":"agent-123","description":"Caller-defined agent or principal id."},"currency":{"type":"string","enum":["USDC","USDT","USD"],"example":"USDC","description":"Policy currency."},"requested_amount":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","example":"250","description":"Requested spend amount."},"remaining_budget":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","example":"100","description":"Remaining budget available to this agent."},"per_transaction_limit":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","example":"150","description":"Maximum amount allowed in one transaction."},"purpose":{"type":"string","pattern":"^[A-Za-z0-9._:-]{2,120}$","example":"api_purchase","description":"Purpose code for the requested spend."},"auto_approval_threshold":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Optional amount above which REVIEW is required even when budget fits."},"idempotency_key":{"type":"string","maxLength":128,"description":"Optional idempotency key for deterministic decision replay."}},"required":["agent_id","currency","requested_amount","remaining_budget","per_transaction_limit","purpose"],"example":{"agent_id":"agent-123","currency":"USDC","requested_amount":"250","remaining_budget":"100","per_transaction_limit":"150","purpose":"api_purchase"}},"example":{"agent_id":"agent-123","currency":"USDC","requested_amount":"250","remaining_budget":"100","per_transaction_limit":"150","purpose":"api_purchase"}}}},"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string"},"schema_version":{"type":"string"},"decision":{"type":"string"},"reason_codes":{"type":"array","items":{"type":"string"}},"requested_amount":{"type":"string"},"remaining_budget":{"type":"string"},"per_transaction_limit":{"type":"string"},"currency":{"type":"string"},"purpose":{"type":"string"},"decision_id":{"type":"string"},"expires_at":{"type":"string"},"policy_version":{"type":"string"},"deterministic":{"type":"boolean"},"llm_used":{"type":"boolean"}},"additionalProperties":true,"x-schema-family":"OPERATION_RUNTIME_RESULT","x-schema-authority":"REPRESENTATIVE_RUNTIME_FIXTURE"},"example":{"product":"nomos-budget-check","schema_version":"1.0","decision":"DENY","reason_codes":["REQUEST_EXCEEDS_REMAINING_BUDGET","REQUEST_EXCEEDS_TRANSACTION_LIMIT"],"requested_amount":"250","remaining_budget":"100","per_transaction_limit":"150","currency":"USDC","purpose":"api_purchase","decision_id":"bud_20261101000000_bdk","expires_at":"2026-11-01T00:10:00.000Z","policy_version":"nomos-budget-check-mvp-v1","deterministic":true,"llm_used":false}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/quicknode/rpc-health":{"get":{"operationId":"getQuicknodeRpcHealth","summary":"Quicknode Rpc Health","description":"Probe a public JSON-RPC endpoint using selected read-only health methods. Reports observed endpoint behavior; it does not submit transactions or require QuickNode credentials. Price: $0.025000 USDC on Base.","parameters":[{"name":"endpoint_url","in":"query","required":true,"schema":{"type":"string","pattern":"^https?://","maxLength":2048,"example":"https://mainnet.base.org"},"example":"https://mainnet.base.org"},{"name":"methods","in":"query","required":false,"schema":{"type":"string","pattern":"^(?:eth_chainId|eth_blockNumber|web3_clientVersion|net_version|eth_syncing)(?:,(?:eth_chainId|eth_blockNumber|web3_clientVersion|net_version|eth_syncing)){0,7}$","example":"eth_chainId,eth_blockNumber","description":"One to eight comma-separated read-only health methods: eth_chainId, eth_blockNumber, web3_clientVersion, net_version or eth_syncing."},"example":"eth_chainId,eth_blockNumber"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"quicknode-rpc-health","schema_version":"1.0","endpoint_origin":"https://mainnet.base.org","checked_methods":["eth_chainId","eth_blockNumber"],"decision":"ALLOW","checks":[{"method":"eth_chainId","outcome":"PASS","result":"0x2105","latency_ms":0},{"method":"eth_blockNumber","outcome":"PASS","result":"0x1234","latency_ms":0}],"limitations":["Endpoint-specific archival, trace, debug, and websocket capabilities need dedicated provider-side checks.","This does not expose or validate the caller's QuickNode credentials beyond the supplied endpoint URL."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/x402/v1/decision/tool-access":{"post":{"operationId":"postNomosToolAccess","summary":"Nomos Tool Access","description":"Assess a caller-declared tool action and environment against a static policy. Advisory report only; it does not grant credentials, execute the tool or enforce access. Price: $0.030002 USDC on Base.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agent_id":{"type":"string","minLength":1,"maxLength":128},"tool_name":{"type":"string","minLength":1,"maxLength":160},"action_type":{"type":"string","minLength":2,"maxLength":120},"environment":{"type":"string","enum":["local","preview","staging","production"]},"idempotency_key":{"type":"string","maxLength":128}},"required":["agent_id","tool_name","action_type"],"example":{"agent_id":"agent-123","tool_name":"web_fetch","action_type":"read","environment":"preview"}},"example":{"agent_id":"agent-123","tool_name":"web_fetch","action_type":"read","environment":"preview"}}}},"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string"},"schema_version":{"type":"string"},"decision":{"type":"string"},"reason_codes":{"type":"array","items":{"type":"string"}},"agent_id":{"type":"string"},"tool_name":{"type":"string"},"action_type":{"type":"string"},"environment":{"type":"string"},"decision_id":{"type":"string"},"expires_at":{"type":"string"},"deterministic":{"type":"boolean"},"llm_used":{"type":"boolean"}},"additionalProperties":true,"x-schema-family":"OPERATION_RUNTIME_RESULT","x-schema-authority":"REPRESENTATIVE_RUNTIME_FIXTURE"},"example":{"product":"nomos-tool-access","schema_version":"1.0","decision":"ALLOW","reason_codes":[],"agent_id":"agent-123","tool_name":"web_fetch","action_type":"read","environment":"preview","decision_id":"toa_20261101000000_80m","expires_at":"2026-11-01T00:10:00.000Z","deterministic":true,"llm_used":false}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/agent/buyer-identity-preflight":{"get":{"operationId":"getAgentBuyerIdentityPreflight","summary":"Agent Buyer Identity Preflight","description":"Compare a caller-declared agent role, purpose and purchase category with a static policy. Advisory report only; no identity verification, registry lookup or purchase authorization is performed. Price: $0.050000 USDC on Base.","parameters":[{"name":"agent_role","in":"query","required":true,"schema":{"type":"string","enum":["research_agent","writer_agent","accounting_agent","finance_agent","operator_agent"],"description":"Declared or credential-mapped buyer agent role.","example":"research_agent"},"example":"research_agent"},{"name":"product_category","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-z0-9_-]{2,80}$","description":"Normalized category of the x402 service, such as wallet_risk, invoice_verification, or market_intelligence.","example":"wallet_risk"},"example":"wallet_risk"},{"name":"purpose","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9_-]{2,80}$","description":"Normalized intended use for the purchase.","example":"security_research"},"example":"security_research"},{"name":"price_usdc","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Quoted x402 price for this purchase.","example":"0.005"},"example":"0.005"},{"name":"data_sensitivity","in":"query","required":false,"schema":{"type":"string","enum":["low","medium","high","restricted"],"description":"Sensitivity level of the service or returned data.","example":"medium"},"example":"medium"},{"name":"agent_status","in":"query","required":false,"schema":{"type":"string","enum":["active","paused","disabled"],"description":"Lifecycle state of the buyer agent."}},{"name":"approval_ref","in":"query","required":false,"schema":{"type":"string","maxLength":160,"description":"Optional human approval reference for elevated purchases."}}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string"},"schema_version":{"type":"string"},"decision":{"type":"string"},"reason_codes":{"type":"array","items":{"type":"string"}},"risk_score":{"type":"integer"},"role_product_fit":{"type":"string"},"input":{"type":"object","properties":{"agent_role":{"type":"string"},"product_category":{"type":"string"},"purpose":{"type":"string"},"price_usdc":{"type":"number"},"data_sensitivity":{"type":"string"},"agent_status":{"type":"string"},"approval_ref":{"type":"string"},"fetched_at":{"type":"string"}},"additionalProperties":true},"recognized_agent_roles":{"type":"array","items":{"type":"string"}},"recommendation":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true,"x-schema-family":"OPERATION_RUNTIME_RESULT","x-schema-authority":"REPRESENTATIVE_RUNTIME_FIXTURE"},"example":{"product":"agent-buyer-identity-preflight","schema_version":"1.0","fetched_at":"2026-11-01T00:00:00.000Z","decision":"ALLOW","reason_codes":["AGENT_ROLE_RECOGNIZED","AGENT_ACTIVE","ROLE_ALLOWED_FOR_PRODUCT_CATEGORY","PRICE_WITHIN_ROLE_LIMIT"],"risk_score":10,"role_product_fit":"fit","input":{"agent_role":"research_agent","product_category":"wallet_risk","purpose":"security_research","price_usdc":0.005,"data_sensitivity":"medium","agent_status":"active","approval_ref":"","fetched_at":"2026-11-01T00:00:00.000Z"},"agent_policy":{"label":"Research Agent","allowed_categories":["wallet_risk","token_risk","market_intelligence","chain_data","api_security","protocol_research"],"approval_categories":["invoice_verification","payment_execution","production_deploy"],"denied_categories":["payroll","customer_pii"],"default_limit_usdc":1},"flags":[],"recommended_next_action":"Proceed to x402 payment only if the payment guard also allows the spend.","audit_required":true,"limitations":["This preflight uses declared or credential-mapped agent role, not proof of human identity.","This endpoint does not custody funds, sign transactions, or settle x402 payments.","Production deployments should bind agent_role to authenticated credentials, not trust query parameters."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/agent/spend-route-plan":{"get":{"operationId":"getAgentSpendRoutePlan","summary":"Agent Spend Route Plan","description":"Suggest a service route for a task and budget using catalog prices. Advisory plan only; unavailable services are identified and the plan does not buy services or enforce spending. Price: $0.050002 USDC on Base.","parameters":[{"name":"task","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":500,"description":"Natural-language task the agent wants to complete.","example":"screen a Base token before buying"},"example":"screen a Base token before buying"},{"name":"budget_usdc","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Maximum planned spend for the route.","example":"0.02"},"example":"0.02"},{"name":"risk_tolerance","in":"query","required":false,"schema":{"type":"string","enum":["low","medium","high"],"description":"How much uncertainty the buyer can tolerate.","example":"medium"},"example":"medium"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"agent-spend-route-plan","schema_version":"1.0","task":"screen a Base token before buying","risk_tolerance":"medium","budget_usdc":0.02,"fetched_at":"2026-11-01T00:00:00.000Z","recommended_route":[{"product":"base-alpha-risk-context","path":"/v1/x402/base/alpha-risk","price_usdc":"$0.003000","list_price_usdc":"$0.003","reason":"Cheap first-pass risk/alpha screen.","stop_if":"Stop or escalate when the selected service reports adverse findings."},{"product":"base-token-exit-risk","path":"/v1/x402/base/token-exit-risk","price_usdc":"$0.003007","list_price_usdc":"$0.003","reason":"Check whether the bot can exit safely before entry or while holding.","stop_if":"Stop or escalate when the selected service reports adverse findings."},{"product":"base-token-alpha-snapshot","path":"/v1/x402/base/token-alpha-snapshot","price_usdc":"$0.003006","list_price_usdc":"$0.003","reason":"Confirm liquidity, volume, and buy/sell imbalance when the first screen passes.","stop_if":"Stop or escalate when the selected service reports adverse findings."}],"full_route":[{"product":"base-alpha-risk-context","path":"/v1/x402/base/alpha-risk","price_usdc":"$0.003000","list_price_usdc":"$0.003","reason":"Cheap first-pass risk/alpha screen.","stop_if":"Stop or escalate when the selected service reports adverse findings."},{"product":"base-token-exit-risk","path":"/v1/x402/base/token-exit-risk","price_usdc":"$0.003007","list_price_usdc":"$0.003","reason":"Check whether the bot can exit safely before entry or while holding.","stop_if":"Stop or escalate when the selected service reports adverse findings."},{"product":"base-token-alpha-snapshot","path":"/v1/x402/base/token-alpha-snapshot","price_usdc":"$0.003006","list_price_usdc":"$0.003","reason":"Confirm liquidity, volume, and buy/sell imbalance when the first screen passes.","stop_if":"Stop or escalate when the selected service reports adverse findings."},{"product":"agent-payment-guard","path":"/v1/x402/payment-guard/evaluate","price_usdc":"$0.100004","list_price_usdc":"$0.10","reason":"Enforce spend budget and recipient policy before paying external services.","stop_if":"Stop or escalate when the selected service reports adverse findings."}],"estimated_cost_usdc":0.009013,"stop_conditions":["Any high-risk or critical flag appears.","Decoded payTo is not on the buyer's allowlist.","Cumulative route cost exceeds budget.","Multiple medium-risk findings appear across route steps."],"escalation":"Budget is too small for the full route; run the affordable prefix and escalate before paying more.","limitations":["This is a routing plan over this service catalog, not a guarantee of task success.","Actual downstream x402 prices can differ from local catalog examples."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/quicknode/wallet-execution-readiness":{"get":{"operationId":"getQuicknodeWalletExecutionReadiness","summary":"Quicknode Wallet Execution Readiness","description":"Combine live Base nonce, gas and stablecoin balance observations for an address. Advisory readiness evidence only; no transaction is signed or submitted. Price: $0.050003 USDC on Base.","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","example":"0x94F751f04b98507D31b500b7Ed50bE68A1514873"},"example":"0x94F751f04b98507D31b500b7Ed50bE68A1514873"},{"name":"gas_limit","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]+$","example":"21000"},"example":"21000"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"quicknode-wallet-execution-readiness","schema_version":"1.0","network":"eip155:8453","address":"0x94F751f04b98507D31b500b7Ed50bE68A1514873","decision":"ALLOW","checks":{"nonce":{"outcome":"PASS","evidence":{"product":"base-nonce-readiness","schema_version":"1.0","network":"eip155:8453","address":"0x94F751f04b98507D31b500b7Ed50bE68A1514873","fetched_at":"2026-11-01T00:00:00.000Z","confirmed_nonce":"0","pending_nonce":"0","pending_transaction_count":"0","ready":true,"decision_hint":"Use nonce 0 for the next transaction.","provenance":{"rpc_providers":["https://base.blockscout.com/api/eth-rpc","https://mainnet.base.org","https://base-rpc.publicnode.com"],"confirmed_block_tag":"latest","pending_block_tag":"pending"}}},"gas":{"outcome":"PASS","evidence":{"product":"base-gas-fee-quote","schema_version":"1.0","network":"eip155:8453","fetched_at":"2026-11-01T00:00:00.000Z","block_number":4660,"gas_limit":"21000","fees":{"gas_price_wei":"1000000000","gas_price_gwei":"1","base_fee_wei":"1000000000","base_fee_gwei":"1","priority_fee_wei":"100000000","priority_fee_gwei":"0.1"},"estimated_cost":{"wei":"21000000000000","eth":"0.000021"},"block_utilization_percent":null,"provenance":{"rpc_providers":["https://base.blockscout.com/api/eth-rpc","https://mainnet.base.org","https://base-rpc.publicnode.com"],"block_tag":"latest"},"limitations":["The estimate uses the supplied gas limit and current gas price, not transaction simulation.","Fees can change before a transaction is submitted or included."]}},"balance":{"outcome":"PASS","evidence":{"product":"base-stablecoin-balance","schema_version":"1.0","network":"eip155:8453","address":"0x94F751f04b98507D31b500b7Ed50bE68A1514873","fetched_at":"2026-11-01T00:00:00.000Z","total_estimated_value_usd":0,"assets":[{"symbol":"USDC","contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","atomic":"0","balance":"0","reference_rate_usd":1,"estimated_value_usd":0,"reputation":"ok"},{"symbol":"USDT","contract":"0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2","atomic":"0","balance":"0","reference_rate_usd":1,"estimated_value_usd":0,"reputation":"ok"},{"symbol":"DAI","contract":"0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb","atomic":"0","balance":"0","reference_rate_usd":1,"estimated_value_usd":0,"reputation":"ok"}],"provenance":{"rpc_providers":["https://base.blockscout.com/api/eth-rpc","https://mainnet.base.org","https://base-rpc.publicnode.com"],"block_tag":"latest"},"limitations":["Reference rates are public metadata and may lag market prices.","Only the three listed Base stablecoin contracts are included."]}}}}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/x402/v1/policy/merchant-check":{"post":{"operationId":"postNomosMerchantCheck","summary":"Nomos Merchant Check","description":"Assess caller-declared merchant trust and purchase fields against a static policy. Advisory report only; it does not verify merchant identity, manage a registry or authorize payment. Price: $0.050004 USDC on Base.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"merchant_id":{"type":"string","minLength":1,"maxLength":160,"example":"merchant-123"},"purpose":{"type":"string","minLength":2,"maxLength":120,"example":"api_purchase"},"amount_usdc":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","example":"25"},"trust_level":{"type":"string","enum":["unknown","known","verified"]},"idempotency_key":{"type":"string","maxLength":128}},"required":["merchant_id","purpose","amount_usdc"],"example":{"merchant_id":"merchant-123","purpose":"api_purchase","amount_usdc":"25","trust_level":"known"}},"example":{"merchant_id":"merchant-123","purpose":"api_purchase","amount_usdc":"25","trust_level":"known"}}}},"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"string"},"schema_version":{"type":"string"},"decision":{"type":"string"},"reason_codes":{"type":"array","items":{"type":"string"}},"merchant_id":{"type":"string"},"purpose":{"type":"string"},"amount_usdc":{"type":"string"},"trust_level":{"type":"string"},"decision_id":{"type":"string"},"expires_at":{"type":"string"},"deterministic":{"type":"boolean"},"llm_used":{"type":"boolean"}},"additionalProperties":true,"x-schema-family":"OPERATION_RUNTIME_RESULT","x-schema-authority":"REPRESENTATIVE_RUNTIME_FIXTURE"},"example":{"product":"nomos-merchant-check","schema_version":"1.0","decision":"ALLOW","reason_codes":[],"merchant_id":"merchant-123","purpose":"api_purchase","amount_usdc":"25","trust_level":"known","decision_id":"mer_20261101000000_88m","expires_at":"2026-11-01T00:10:00.000Z","deterministic":true,"llm_used":false}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/agent/capability-security-preflight":{"get":{"operationId":"getAgentCapabilitySecurityPreflight","summary":"Agent Capability Security Preflight","description":"Combine selected public agent-card, repository, package, domain, OpenAPI and unpaid x402 observations. Advisory report with explicit missing or unavailable checks; no target payment or enforcement is performed. Price: $0.100000 USDC on Base.","parameters":[{"name":"target_type","in":"query","required":true,"schema":{"type":"string","enum":["agent","package","repository","api","capability"],"description":"Capability type being evaluated.","example":"agent"},"example":"api"},{"name":"identifier","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":512,"description":"Human-readable package, repository, agent, API, or capability identifier.","example":"https://base-agent-preflight.bytoken2023.workers.dev"},"example":"https://nohands-coinbase-bazaar.bytoken2023.workers.dev"},{"name":"agent_card_url","in":"query","required":false,"schema":{"type":"string","pattern":"^https?://","maxLength":2048,"example":"https://base-agent-preflight.bytoken2023.workers.dev"}},{"name":"github_owner","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$","example":"cloudflare"},"example":"cloudflare"},{"name":"github_repo","in":"query","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,100}$","example":"workers-sdk"},"example":"workers-sdk"},{"name":"npm_package","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":214,"example":"express"},"example":"express"},{"name":"npm_version","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":80,"example":"latest"},"example":"4.18.2"},{"name":"domain","in":"query","required":false,"schema":{"type":"string","pattern":"^(?=.{1,253}$)(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)+[A-Za-z]{2,63}$","example":"github.com"},"example":"github.com"},{"name":"openapi_url","in":"query","required":false,"schema":{"type":"string","pattern":"^https?://","maxLength":2048,"example":"https://base-agent-preflight.bytoken2023.workers.dev/openapi.json"},"example":"https://nohands-coinbase-bazaar.bytoken2023.workers.dev/openapi.json"},{"name":"x402_url","in":"query","required":false,"schema":{"type":"string","pattern":"^https?://","maxLength":2048,"example":"https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/base/alpha-risk"},"example":"https://nohands-coinbase-bazaar.bytoken2023.workers.dev/v1/endpoint-preflight?url=https%3A%2F%2Fexample.com%2Fpaid-api"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"decision":"REVIEW","decision_id":"cap_20261101000000_g98","policy_version":"agent-capability-security-v1","pricing_version":"x402-pricing-v2-resource-binding-20260910","target":{"type":"api","identifier":"https://nohands-coinbase-bazaar.bytoken2023.workers.dev"},"checks":[{"check":"agent_card","status":"unavailable","reason_codes":["AGENT_CARD_URL_MISSING"],"evidence":{},"provider_failure":false,"provider_called":false,"provider_failure_reason_codes":[]},{"check":"github_repository_health","status":"pass","reason_codes":["GITHUB_REPOSITORY_HEALTH_PASS"],"evidence":{"product":"github-repository-health","risk_level":"low","risk_score":0,"fingerprint_sha256":null,"resolved_version":null,"repository":{"full_name":null,"archived":null,"pushed_at":null},"domain":null,"agent":null,"x402":null},"provider_failure":false,"provider_called":true,"provider_failure_reason_codes":[]},{"check":"npm_package_preflight","status":"pass","reason_codes":["NPM_PACKAGE_PREFLIGHT_PASS"],"evidence":{"product":"npm-package-preflight","risk_level":"low","risk_score":0,"fingerprint_sha256":null,"resolved_version":"4.18.2","repository":null,"domain":null,"agent":null,"x402":null},"provider_failure":false,"provider_called":true,"provider_failure_reason_codes":[]},{"check":"domain_trust","status":"pass","reason_codes":["DOMAIN_TRUST_PASS"],"evidence":{"product":"domain-trust-preflight","risk_level":"low","risk_score":0,"fingerprint_sha256":null,"resolved_version":null,"repository":null,"domain":"github.com","agent":null,"x402":null},"provider_failure":false,"provider_called":true,"provider_failure_reason_codes":[]},{"check":"openapi_spec","status":"pass","reason_codes":["NO_SECURITY_SCHEMES"],"evidence":{"product":"openapi-spec-preflight","risk_level":"low","risk_score":5,"fingerprint_sha256":"4f519b6dffc2380806c3f6fb52a2a42dacdefca0cc24934172db580fc8cb5456","resolved_version":null,"repository":null,"domain":null,"agent":null,"x402":null},"provider_failure":false,"provider_called":true,"provider_failure_reason_codes":[]},{"check":"x402_endpoint","status":"pass","reason_codes":["X402_ENDPOINT_PASS"],"evidence":{"product":"x402-endpoint-preflight","risk_level":"low","risk_score":0,"fingerprint_sha256":null,"resolved_version":null,"repository":null,"domain":null,"agent":null,"x402":{"version":2,"accepts":[{"scheme":"exact","network":"eip155:8453","amount_usdc":0.015002}]}},"provider_failure":false,"provider_called":true,"provider_failure_reason_codes":[]}],"summary":{"passed":5,"warned":0,"failed":0,"unavailable":1},"reason_codes":["AGENT_CARD_URL_MISSING","GITHUB_REPOSITORY_HEALTH_PASS","NPM_PACKAGE_PREFLIGHT_PASS","DOMAIN_TRUST_PASS","NO_SECURITY_SCHEMES","X402_ENDPOINT_PASS"],"provider_failure_applicable":true,"provider_failure_detected":false,"provider_failure_reason_codes":[],"fail_closed":false,"generated_at":"2026-11-01T00:00:00.000Z"}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}},"/v1/x402/agent/rpc-payment-guard":{"get":{"operationId":"getX402RpcPaymentGuard","summary":"X402 Rpc Payment Guard","description":"Assess a proposed RPC purchase against caller-supplied amount and budget fields. Advisory report only; signer and replay fields are recommendations, not enforced controls, signed authorization or a payment token. Price: $0.100001 USDC on Base.","parameters":[{"name":"request_id","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,128}$","description":"Caller-defined idempotency key for this RPC purchase.","example":"rpc-request-1"},"example":"rpc-request-1"},{"name":"endpoint_url","in":"query","required":true,"schema":{"type":"string","pattern":"^https?://","maxLength":2048,"description":"RPC, x402, REST, or indexed chain-data endpoint URL.","example":"https://x402.example.com/rpc/base"},"example":"https://x402.example.com/rpc/base"},{"name":"chain","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9:_ -]{2,80}$","description":"Requested chain or CAIP-2 network label.","example":"base"},"example":"base"},{"name":"method","in":"query","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{2,80}$","description":"RPC method, REST operation, or query action.","example":"eth_getLogs"},"example":"eth_getLogs"},{"name":"pay_to","in":"query","required":false,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Payment recipient address.","example":"0x94F751f04b98507D31b500b7Ed50bE68A1514873"},"example":"0x94F751f04b98507D31b500b7Ed50bE68A1514873"},{"name":"amount_usdc","in":"query","required":true,"schema":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Requested stablecoin payment amount.","example":"0.001"},"example":"0.001"},{"name":"max_single_usdc","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Maximum allowed amount for one RPC/data purchase.","example":"0.01"},"example":"0.01"},{"name":"session_budget_usdc","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]{1,6})?$","description":"Remaining budget for this agent session.","example":"1.00"},"example":"1.00"}],"responses":{"200":{"description":"Report after successful x402 payment.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"x-schema-family":"STRUCTURED_PRODUCT_RESULT","x-schema-authority":"STRUCTURED_PRODUCT_RESULT"},"example":{"product":"x402-rpc-payment-guard","schema_version":"1.0","fetched_at":"2026-11-01T00:00:00.000Z","request_id":"rpc-request-1","endpoint":{"requested_url":"https://x402.example.com/rpc/base","origin":"https://x402.example.com","host":"x402.example.com","chain":"base","method":"eth_getLogs"},"payment":{"pay_to":"0x94F751f04b98507D31b500b7Ed50bE68A1514873","amount_usdc":0.001,"max_single_usdc":0.01,"session_budget_usdc":1,"protocol":"x402"},"decision":"ALLOW","signer_directive":"sign_only_if_wallet_policy_matches_this_request","assessment":{"risk_level":"low","risk_score":0,"flags":[]},"replay_protection":{"idempotency_key":"rpc-request-1","bind_endpoint_origin":"https://x402.example.com","bind_method":"eth_getLogs","bind_chain":"base"},"limitations":["This public wrapper does not mint a production authorization token.","Use owner-controlled signer policy, KMS, MPC, or smart-account modules for real signing."]}}}},"400":{"description":"Invalid business input; payment is not verified or settled."},"402":{"description":"Standard x402 payment required. An official x402 client reads PAYMENT-REQUIRED and supplies PAYMENT-SIGNATURE."},"503":{"description":"Payment facilitator or business data source is unavailable."}}}}}}