{"uid":"cap_NlgzeWxT948qkrqb0f_Sl","slug":"spendthebits-gift-card-quote-b6de08c9","name":"SpendTheBits Gift Card Quote","description":"Buy a gift card from ~550 US brands (Amazon, Target, DoorDash, Uber ...) and more countries; the card is issued to the agent's owner (registered STB agent key with gift cards turned on required). This call prices one card for a $0.02 USDC fee on Base and returns the exact USDC total, a pay_url and a claim token. Find product ids and amounts with GET /x402/giftcards/catalog/?country=USA.","url":"https://x402.spendthebits.com/x402/giftcards/quote/?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"ref":{"type":"string","maxLength":80,"description":"Optional referrer STB handle (@name) that earns part of the service fee"},"brand":{"type":"string","maxLength":80,"description":"Optional brand name; only used to suggest real products when product_id is not found"},"amount":{"type":"number","description":"Face value in the card's own currency; a fixed-denomination card takes one of its listed denominations","exclusiveMinimum":0},"country":{"type":"string","minLength":1,"description":"Catalogue country name, e.g. USA, Canada, UK"},"product_id":{"type":"string","minLength":1,"description":"Product id from GET /x402/giftcards/catalog/?country=<country>"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5swOj7bizBq2RwPaM0SA-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Prices a gift card from ~550 US brands and returns the exact USDC total, a payment URL, and a claim token for purchase","exampleAgentPrompt":"Can you price me a $50 Amazon gift card for the USA using my SpendTheBits agent key — I want to see the exact USDC total and the payment URL so I can complete the purchase?","exampleUseCases":[{"title":"Agent-purchased DoorDash gift card","prompt":"Quote me a $25 DoorDash gift card for the USA — give me the USDC amount and the payment link so I can buy it right now."},{"title":"Corporate gifting with referral credit","prompt":"I want to send a $100 Target gift card to someone in the USA; use my referral handle @mystore and give me the quoted USDC price and claim token."},{"title":"International gift card pricing","prompt":"How much would a £20 gift card from a UK brand cost in USDC? Use product ID GBP-AMAZON-20 for country UK and give me the pay URL."}],"resultDescription":"Returns the exact USDC total required (including the $0.02 service fee on Base), a pay_url to complete payment, and a claim token that will be used to retrieve the issued gift card after payment is confirmed.","failureModes":["Invalid or unrecognized product_id returns an error suggesting to check the catalog endpoint","Amount not matching fixed denominations for the selected card results in a validation error","Unregistered or gift-card-disabled STB agent key returns an authorization error","Unsupported country name returns a catalog error","Network issues or Base chain congestion may delay response"],"whenToPreferThis":"Use this endpoint when you need to programmatically price and initiate a gift card purchase for ~550 US or international brands using USDC on Base, especially when operating as an AI agent with a registered SpendTheBits agent key. Prefer this over generic gift card APIs when payment is crypto-native (USDC/Base) and you need a claim token workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:37:53.663Z","isFirstParty":false,"canonicalSlug":"spendthebits-gift-card-quote-b6de08c9"}