For integrations

Programmatic card issuance

Generate a unique seed, issue a virtual card in pending_top_up state, and receive a funding wallet address — all in a single API call.

Quick start Full API reference
REST JSON Seed auth Funding wallet
Visa
Agent-issued
4719 38•• •••• ••••
Issued byseed_…
CreatedJust now
InstantJSON response
SeedUnique credential
Visa / MCNetwork selection
WalletFunding address included
What you can build

Six patterns this API was built for

The endpoints below are the foundation — the patterns are what agent builders actually ship.

Autonomous spend agents

Agents that decide what to buy and execute the purchase without human approval. The API issues a fresh card per transaction, charges it, then deletes it — leaving no reusable payment surface in the wild.

Ad-campaign automation

Programmatic issuance of one BIN-471938 (Visa Business) card per Meta / Google / TikTok ad account. Rotate cards every 30-60 days to keep accounts clean.

Per-user disposable cards

Marketplaces or platforms that need a unique card per end-user transaction. Issue, charge, delete in under 10 seconds — no PCI scope, no card-storage burden.

Free-trial harvesters

Sign up to free trials at scale. Each trial gets a card with the minimum load; deletion before renewal blocks the auto-charge cleanly.

SaaS billing per workspace

Multi-tenant agents that bill upstream SaaS (AWS, OpenAI, Cloudflare, GitHub) on a per-workspace card. Costs become attributable to the customer without leaking your master billing identity.

Scraping / signup workers

Each worker requests a card via the API the moment it needs a payment surface, uses it for the intended action, then closes it. The $1.50 unit cost is a fraction of any alternative approach.

Quick start

Generate a seed, card, and wallet in 1 call

This endpoint returns a unique seed, a card in pending_top_up state, and a funding wallet address selected by asset. Use X-Seed on subsequent requests.

OpenAPI 3.1 /.well-known/openapi.json Plugin manifest /.well-known/ai-plugin.json Machine descriptor /.well-known/agent.json

1. Generate (seed + card + wallet)

curl "https://cryptocardy.com/v1/api?card=visa&asset=BTC"
import json
import requests
r = requests.get(
    "https://cryptocardy.com/v1/api",
    params={"card": "visa", "asset": "BTC"},
).json()
print(json.dumps(r, indent=2))
const r = await fetch("https://cryptocardy.com/v1/api?card=visa&asset=BTC").then(r => r.json());
console.log(JSON.stringify(r, null, 2));
Integration files

Machine-readable API metadata

Use these files to discover endpoints, request/response schemas, and authentication headers.

TypePathDescription
GET/.well-known/openapi.jsonOpenAPI specification for the REST API.
GET/.well-known/ai-plugin.jsonPlugin manifest (references the OpenAPI spec).
GET/.well-known/agent.jsonMachine descriptor (links to spec + docs).
GET/llms.txtShort integration overview and URLs.
API surface

All endpoints at a glance

Use the base URL https://cryptocardy.com/v1/api.

MethodPathDescription
GET/v1/apiGenerate a seed, return a card in pending_top_up state, and provide a funding wallet address. Optional query params: card, asset.
Security model

Seed-based access, no password resets

Your seed is the credential. Store it securely and send it using the X-Seed header. If you lose the seed, access cannot be restored.

Card state

Cards are returned with card.state set to pending_top_up, so an integration can detect that the card exists but requires funding before activation.

Start integrating in minutes

Use the quick start to generate a seed, card, and funding wallet, then follow the API reference for parameters and response fields.

Read the quick start