Saltar al contenido principal
Mint test tokens
Este endpoint funciona solo contra https://api.sandbox.spherepay.co. Emite SPHEREUSDC, la stablecoin de prueba de sandbox, a la dirección indicada en una red de prueba (ethereum es Sepolia, sol es Solana Devnet). La emisión se envía de forma asíncrona, así que consulta Recuperar una Emisión de Tokens de Prueba para obtener el hash de la transacción. Envía un header Idempotency-Key para que los reintentos sean seguros: la misma clave devuelve la misma emisión, y reutilizar una clave con parámetros distintos devuelve 409. Los límites son 10 emisiones por hora por aplicación, como máximo 1000 por emisión, y un tope de saldo por billetera de 10000 (409 cuando una emisión lo superaría).

Autorizaciones

Authorization
string
header
requerido

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

Encabezados

Idempotency-Key
string

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

Cuerpo

application/json
address
string
requerido

Wallet address that receives the tokens.

Required string length: 1 - 255
Ejemplo:

"0xdEc79ba951875fc930F5309181d5b71b821E97FE"

network
enum<string>
requerido

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

Opciones disponibles:
ethereum,
sol
Ejemplo:

"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+)?$
Ejemplo:

"1000"

Respuesta

address
string
requerido
amount
string
requerido
createdAt
string
requerido
currency
enum<string>
requerido
Opciones disponibles:
SPHEREUSDC
id
string
requerido

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

network
enum<string>
requerido
Opciones disponibles:
ethereum,
sol
status
enum<string>
requerido

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

Opciones disponibles:
pending,
submitted,
succeeded,
failed
txHash
string | null
requerido
Última modificación el 16 de noviembre de 2026