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. Examples use real mainnet token and contract addresses with placeholder wallets, hashes, signatures, and IDs.

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