Skip to main content
Mint test tokens
This endpoint works only against https://api.sandbox.spherepay.co. It mints SPHEREUSDC, the sandbox test stablecoin, to the given address on a test network (ethereum is Sepolia, sol is Solana Devnet). The mint is submitted asynchronously, so poll Retrieve a Test Token Mint for the transaction hash. Send an Idempotency-Key header to make retries safe: the same key returns the same mint, and reusing a key with different parameters returns 409. Limits are 10 mints per hour per application, at most 1000 per mint, and a wallet balance cap of 10000 (409 when a mint would exceed it).

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Caller idempotency key (1 to 128 characters: letters, digits, "_", ".", ":" or "-"). Scoped to the application.

Body

application/json
address
string
required

Wallet address that receives the tokens.

Required string length: 1 - 255
Example:

"0xdEc79ba951875fc930F5309181d5b71b821E97FE"

network
enum<string>
required

Test network to mint on: ethereum (Sepolia) or sol (Solana Devnet).

Available options:
ethereum,
sol
Example:

"ethereum"

amount
string

Amount of SPHEREUSDC in human units, as a decimal string. Defaults to 1000; at most 1000 per request. A mint that would take the wallet above 10000 SPHEREUSDC, counting mints still pending, is refused with 409.

Pattern: ^\d+(\.\d+)?$
Example:

"1000"

Response

address
string
required
amount
string
required
createdAt
string
required
currency
enum<string>
required
Available options:
SPHEREUSDC
id
string
required

Mint id. Poll GET /v2/sandbox/faucet/{id} for the tx hash.

network
enum<string>
required
Available options:
ethereum,
sol
status
enum<string>
required

pending: queued; submitted: sent to the chain; succeeded: confirmed on chain (txHash set); failed: not minted, request again with a new Idempotency-Key.

Available options:
pending,
submitted,
succeeded,
failed
txHash
string | null
required
Last modified on November 16, 2026