{"uid":"cap_B9VXKmDZoRgXp_kDpnreg","slug":"no-hands-ai-btc-usd-live-quote-ad7eaf28","name":"NO HANDS AI BTC/USD Live Quote","description":"Return a source-backed live BTC to USD quote for autonomous-agent budget checks.","url":"https://nohands-coinbase-bazaar.bytoken2023.workers.dev/x402/v1/value/btc-usd?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"amount":{"type":"string","example":"1","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."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","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"],"properties":{"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]))$"},"source":{"type":"string","const":"live_market_quote"},"product":{"type":"string","const":"nomos-value-btc-usd"},"sources":{"type":"array","items":{"type":"object","required":["leg","provider","provider_role","venue","market","pair","value","observed_at","observation_type","timestamp_origin","fetched_at","freshness_seconds"],"properties":{"leg":{"type":"string","const":"crypto_usd"},"pair":{"type":"string"},"value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"venue":{"type":"string"},"market":{"type":"string"},"provider":{"enum":["Kraken","Bitfinex"],"type":"string"},"fetched_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"provider_role":{"enum":["primary","fallback"],"type":"string"},"observation_type":{"enum":["recent_trade","ticker_snapshot"],"type":"string"},"timestamp_origin":{"enum":["exchange_trade_time","fetch_completion_time"],"type":"string"},"freshness_seconds":{"type":"integer","maximum":180,"minimum":0}},"additionalProperties":false},"maxItems":1,"minItems":1},"provider":{"enum":["Kraken","Bitfinex"],"type":"string"},"result_id":{"type":"string","pattern":"^val_[0-9]{14}_[0-9a-z]+$"},"quote_type":{"type":"string","const":"live"},"unit_price":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"fallback_used":{"type":"boolean"},"market_status":{"type":"string","const":"fresh"},"provider_role":{"enum":["primary","fallback"],"type":"string"},"quote_currency":{"type":"string","const":"USD"},"schema_version":{"type":"string","const":"2.0"},"converted_value":{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"},"fallback_reason":{"enum":[null,"primary_timeout","primary_http_error","primary_network_error","primary_invalid_payload","primary_stale"],"type":["string","null"]},"freshness_seconds":{"type":"integer","minimum":0},"source_observed_at":{"type":"string","format":"date-time"},"response_generated_at":{"type":"string","format":"date-time"}},"x-schema-family":"FX_LIVE_QUOTE_V2","x-schema-authority":"SHARED_FX_LIVE_QUOTE_CONTRACT","additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NhNNHAOOexfQRbUIG5_ju","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a source-backed live Bitcoin to USD price quote with freshness metadata for use in autonomous-agent budget checks.","exampleAgentPrompt":"What's the current live Bitcoin price in USD right now? I need a source-backed quote with freshness info to check if my 0.25 BTC budget is enough.","exampleUseCases":[{"title":"Agent budget check before crypto payment","prompt":"Before I authorize this payment, check the live BTC to USD rate so I know whether my 0.1 BTC is enough to cover the $900 invoice."},{"title":"Portfolio snapshot in USD","prompt":"What is 2.5 BTC worth in US dollars right now? I need a live market quote with the data source and how fresh the price is."},{"title":"Autonomous agent cost threshold guard","prompt":"Fetch the current BTC/USD price for me — I need to know the real-time rate so my agent can decide whether to proceed with the transaction based on my dollar budget cap."}],"resultDescription":"A JSON object containing the BTC/USD unit price, the converted USD value for the requested BTC amount, the quote currency, market status, data freshness in seconds, the timestamp when the source price was observed, and an array of source legs detailing each price provider, venue, trading pair, and observation type used to construct the quote.","failureModes":["Upstream market data provider unavailable — returns fallback flag with fallback_reason populated","Invalid or malformed amount query parameter — returns 400 with validation error","Payment not received or x402 payment verification failure — returns 402 requiring USDC payment","Service worker timeout or Cloudflare edge error — returns 500 or 503","Rate freshness degraded — fallback_used flag set to true with stale timestamp"],"whenToPreferThis":"Choose this endpoint when an autonomous agent needs a source-attributed, freshness-stamped live BTC/USD quote rather than a bare price ticker. It is especially useful when the agent must justify a budget decision with a traceable source, needs market status context, or requires the converted USD value for a specific BTC amount in a single call. Prefer it over generic price feeds when auditability and multi-source backing matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:10.701Z","isFirstParty":false,"canonicalSlug":"no-hands-ai-btc-usd-live-quote-ad7eaf28"}