Pular para o conteúdo principal
Mint test tokens
Este endpoint funciona apenas em https://api.sandbox.spherepay.co. Ele emite SPHEREUSDC, a stablecoin de teste do sandbox, para o endereço informado em uma rede de teste (ethereum é Sepolia, sol é Solana Devnet). A emissão é enviada de forma assíncrona, então consulte Recuperar uma Emissão de Tokens de Teste para obter o hash da transação. Envie um header Idempotency-Key para tornar as novas tentativas seguras: a mesma chave retorna a mesma emissão, e reutilizar uma chave com parâmetros diferentes retorna 409. Os limites são 10 emissões por hora por aplicação, no máximo 1000 por emissão, e um teto de saldo por carteira de 10000 (409 quando uma emissão o ultrapassaria).

Autorizações

Authorization
string
header
obrigatório

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

Cabeçalhos

Idempotency-Key
string

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

Corpo

application/json
address
string
obrigatório

Wallet address that receives the tokens.

Required string length: 1 - 255
Exemplo:

"0xdEc79ba951875fc930F5309181d5b71b821E97FE"

network
enum<string>
obrigatório

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

Opções disponíveis:
ethereum,
sol
Exemplo:

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

"1000"

Resposta

address
string
obrigatório
amount
string
obrigatório
createdAt
string
obrigatório
currency
enum<string>
obrigatório
Opções disponíveis:
SPHEREUSDC
id
string
obrigatório

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

network
enum<string>
obrigatório
Opções disponíveis:
ethereum,
sol
status
enum<string>
obrigatório

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

Opções disponíveis:
pending,
submitted,
succeeded,
failed
txHash
string | null
obrigatório
Última modificação em 16 de novembro de 2026