Skip to main content
POST
Initiate a gasless deposit with ERC-3009
Funds a deposit address gaslessly with a signed ERC-3009 transferWithAuthorization. target.depositAddress must equal authorization.to. The first submission answers 202 with a gasless job; resending the same signature returns the existing job with 200. No API key is required: Circle Gateway operations are open so that any wallet or relay can create and fund a deposit address. A supplied key that is unknown, revoked, or not enabled for v1 is still rejected with 401 invalid-api-key, so send no key rather than a wrong one. No requests-per-second quota is published. Handle 429 and honor Retry-After when present. See Errors and retries for common errors and retry handling. Examples use mainnet token and contract addresses with placeholder wallets, hashes, signatures, and IDs. They are illustrative and must not be used to transfer funds.

Headers

x-api-key
string

Optional. A key that is unknown, revoked, or not enabled for v1 is rejected with 401.

Body

application/json
chainId
integer
required
authorization
object
required
signature
string
required
Required string length: 130 - 132
target
object
required

Response

Existing job for the same signature and target.

id
string
required
status
enum<string>
required
Available options:
pending,
processing,
published,
partial,
failed,
unknown
signatureHash
string
required
subStatuses
object[]
required
createdAt
integer
required
updatedAt
integer
required