SpendTheBits
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.05 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.
Offering
- Provider
- x402.spendthebits.com
- Method
- POST
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Blockchain And Crypto
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://x402.spendthebits.com/x402/giftcards/quote- MIME type
- application/json
- First seen
- 2026-10-16T01:50:38.788Z
- Last seen
- Tags
- gift-cards, shopping, commerce, Payments, USDC
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.05 USDC
Atomic price: 50000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "50000",
"payTo": "0xCAB797230Aa7A9cAA2d6Da4AC8b2a06416225cA9"
}
]Observed health
- Status
- Healthy
- Latest latency
- 66 ms
- Average latency
- 774 ms
- HTTP status
- 200
- Last checked
- Reachability
- 100% over 14 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"type": "string",
"enum": [
"POST",
"PUT",
"PATCH"
]
},
"bodyType": {
"type": "string",
"enum": [
"json",
"form-data",
"text"
]
},
"body": {
"type": "object",
"properties": {
"product_id": {
"type": "string",
"minLength": 1,
"description": "Product id from GET /x402/giftcards/catalog/?country=<country>"
},
"country": {
"type": "string",
"minLength": 1,
"description": "Catalogue country name, e.g. USA, Canada, UK"
},
"amount": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Face value in the card's own currency; a fixed-denomination card takes one of its listed denominations"
},
"brand": {
"type": "string",
"maxLength": 80,
"description": "Optional brand name; only used to suggest real products when product_id is not found"
},
"ref": {
"type": "string",
"maxLength": 80,
"description": "Optional referrer STB handle (@name) that earns part of the service fee"
}
},
"required": [
"product_id",
"country",
"amount"
],
"additionalProperties": false
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"additionalProperties": false
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"amount": {
"description": "Face value in the card's own currency; a fixed-denomination card takes one of its listed denominations",
"exclusiveMinimum": 0,
"type": "number"
},
"brand": {
"description": "Optional brand name; only used to suggest real products when product_id is not found",
"maxLength": 80,
"type": "string"
},
"country": {
"description": "Catalogue country name, e.g. USA, Canada, UK",
"minLength": 1,
"type": "string"
},
"product_id": {
"description": "Product id from GET /x402/giftcards/catalog/?country=<country>",
"minLength": 1,
"type": "string"
},
"ref": {
"description": "Optional referrer STB handle (@name) that earns part of the service fee",
"maxLength": 80,
"type": "string"
}
},
"required": [
"product_id",
"country",
"amount"
],
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"ask": {
"type": "object"
},
"brand": {
"type": "string"
},
"card_url": {
"type": [
"string",
"null"
]
},
"claim_token": {
"description": "Secret for status_url; shown once",
"type": "string"
},
"currency": {
"type": "string"
},
"delivery": {
"type": "string"
},
"detail": {
"type": "string"
},
"face_value": {
"description": "Card value in its own currency",
"type": "string"
},
"includes": {
"properties": {
"bridge_fee_ceiling_usdc": {
"type": "string"
},
"card_usdc": {
"type": "string"
},
"service_fee_usdc": {
"type": "string"
}
},
"type": "object"
},
"order_id": {
"description": "Use it in pay_url / status_url",
"type": "string"
},
"pay_by": {
"description": "Unix time the quote lapses",
"type": "integer"
},
"pay_to": {
"description": "Per-order forwarder contract on Base",
"type": "string"
},
"pay_url": {
"description": "x402 URL that takes the payment",
"type": "string"
},
"pricing_note": {
"type": "string"
},
"redeemable_in": {
"type": "string"
},
"referral": {
"type": "object"
},
"spend_controls_hint": {
"type": "string"
},
"status": {
"description": "awaiting_payment, awaiting_owner, paid, completed, declined ...",
"type": "string"
},
"status_url": {
"description": "Poll with the X-Claim-Token header",
"type": "string"
},
"total_usdc": {
"description": "EXACT USDC to pay at pay_url, decimal string",
"type": "string"
},
"typical_minutes": {
"type": "integer"
},
"valid_until": {
"description": "Provider validity date once issued; null until then"
},
"what_to_expect": {
"type": "string"
}
},
"required": [
"order_id",
"status",
"brand",
"face_value",
"currency",
"total_usdc",
"includes",
"pay_to",
"pay_by",
"typical_minutes",
"what_to_expect",
"valid_until"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}