# SpendTheBits Gift Card Quote

> SpendTheBits Gift Card Quote is a paid API for AI agents from x402.spendthebits.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-11).

Prices a gift card from ~550 US brands and returns the exact USDC total, a payment URL, and a claim token for purchase

## Facts

- Endpoint: POST https://x402.spendthebits.com/x402/giftcards/quote/?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/spendthebits-gift-card-quote-b6de08c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NlgzeWxT948qkrqb0f_Sl

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability spendthebits-gift-card-quote-b6de08c9 -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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>"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/spendthebits-gift-card-quote-b6de08c9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.spendthebits.com](https://www.zero.xyz/host/x402.spendthebits.com/llms.txt)