Skip to main content
GET
Check the status of a deposit
Returns a deposit address’s state, quoted amount, deadline, and destination intentHash. sourceChainId is required. An unknown address returns 404 in the deposit-address error format. Responses keep the { data: … } envelope. 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.

Path Parameters

vaultAddress
string
required

The vaultAddress returned when the deposit address was created. EIP-55 / lowercase hex 20-byte address

Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

Query Parameters

sourceChainId
number
required

The sourceChainId the deposit address was created for. Required; omitting it returns 400.

Example:

8453

Response

Quoted vault record retrieved successfully

data
object
required