Skip to main content
POST
Request gTESTUSDC

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string<uuid>
required

Client-generated UUID v4. Reusing it with the same request returns the existing transfer; reusing it with different input returns 409.

Body

application/json
address
string
required

Nonzero EVM address that will receive gTESTUSDC on Tempo Moderato.

Example:

"0x1111111111111111111111111111111111111111"

amount
string
required

gTESTUSDC amount as a decimal string. Must be greater than zero and no more than 100, with up to six decimal places.

Pattern: ^(?:0|[1-9][0-9]*)(?:\.[0-9]{1,6})?$
Example:

"25.000000"

Response

Existing faucet transfer returned for an idempotent replay.

id
string<uuid>
required
status
enum<string>
required
Available options:
requested,
processing,
submitted,
confirmed,
failed
chain
enum<string>
required
Available options:
tempo_moderato
token
enum<string>
required
Available options:
gtestusdc
address
string
required

EVM address receiving the gTESTUSDC.

amount
string
required

Requested gTESTUSDC amount with six decimal places.

Pattern: ^[0-9]+\.[0-9]{6}$
transactionHash
string | null
required

Tempo Moderato transaction hash once submitted.

failureCode
string | null
required

Machine-readable failure code when status is failed. faucet_privy_server_error_retry_exhausted means the provider server error persisted after one retry and no transfer was submitted.

createdAt
string<date-time> | null
required
submittedAt
string<date-time> | null
required
confirmedAt
string<date-time> | null
required