Skip to main content
POST
Request mock USDT
Submit a faucet request for the wallet’s depositAddresses.ethereum_sepolia address, then poll the returned request ID until it is confirmed or failed. Use a new UUID v4 Idempotency-Key for each intended transfer. Reusing the key returns the original request without sending another transfer.

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 mock USDT on Ethereum Sepolia.

Example:

"0x1111111111111111111111111111111111111111"

amount
string
required

Mock USDT 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:
ethereum_sepolia
token
enum<string>
required
Available options:
usdt
address
string
required

EVM address receiving the mock USDT.

amount
string
required

Requested mock USDT amount with six decimal places.

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

Ethereum Sepolia transaction hash once submitted.

failureCode
string | null
required

Machine-readable failure code when status is failed.

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