Request faucet deposit

This operation sends testnet tokens to the specified wallet address. Provide address (an on-chain address registered to one of your wallets) and token_id (a token available from the faucet). Call the List faucet tokens operation to see available tokens.

Daily deposit limits apply per token. The operation returns HTTP 429 if the daily limit has been reached.

POST /api/v1/faucet/deposit

Request faucet deposit

Python

import requests

url = "https://api.example.com/api/v1/faucet/deposit"

payload = {
    "address": "<string>",
    "token_id": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

200

{
  "result": {
    "address": "<string>",
    "token_id": "<string>",
    "amount": "<string>",
    "result": {}
  },
  "success": true,
  "suggestion": "",
  "message": "",
  "meta": {
    "total": 123,
    "offset": 123,
    "limit": 123,
    "has_more": true,
    "after": "<string>",
    "before": "<string>"
  }
}

Headers

X-API-Key · string | null

Body

application/json

address · string · required

Destination address to receive test tokens

token_id · string · required

Token identifier, e.g. SETH_USDC

Response

200

application/json

Successful Response

result · FaucetDepositResult · object · required

Show child attributes

success · boolean · default: true

suggestion · string · default: ""

message · string · default: ""

meta · PaginationMeta · object

Pagination metadata for list responses.

Supports both legacy offset-based and cursor-based pagination. Cursor fields (has_more, after, before) are populated for cursor-paginated endpoints. Legacy fields (offset, limit) are populated when the caller uses the deprecated offset parameter.

Show child attributes