curl --request POST \
--url https://api.eco.com/v1/circle-gateway/deposit-addresses \
--header 'Content-Type: application/json' \
--data '
{
"sourceChainId": 8453,
"amount": "1000000",
"recipient": "0x70997970C51812dc3A010C7d01b50e0d17dc79C8",
"depositor": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
}
'{
"data": {
"vaultAddress": "0x379BAB257e7Eb159538F01165B766A1BEaf2D954",
"amount": "1000000",
"deadline": 1789526504
}
}Circle Gateway fast deposits
Get a Circle Gateway deposit address
Creates a quoted Circle Gateway deposit address and returns it with the quoted amount and deadline.
POST
/
v1
/
circle-gateway
/
deposit-addresses
curl --request POST \
--url https://api.eco.com/v1/circle-gateway/deposit-addresses \
--header 'Content-Type: application/json' \
--data '
{
"sourceChainId": 8453,
"amount": "1000000",
"recipient": "0x70997970C51812dc3A010C7d01b50e0d17dc79C8",
"depositor": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
}
'{
"data": {
"vaultAddress": "0x379BAB257e7Eb159538F01165B766A1BEaf2D954",
"amount": "1000000",
"deadline": 1789526504
}
}Creates a quoted Circle Gateway deposit address and returns it as
vaultAddress, with the quoted amount and the quote deadline (Unix seconds). The address must receive at least amount before deadline, gaslessly or by plain transfer. Repeating the same request while the quote is pending returns the same address. Responses keep the { data: … } envelope and the deposit-address validation error format.
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
Optional. A key that is unknown, revoked, or not enabled for v1 is rejected with 401.
Body
application/json
Source chain of the deposit.
Required range:
x >= 1Example:
8453
Required positive integer source-chain USDC amount in base units. Must fit uint256.
Example:
"1000000"
Gateway depositFor target on the destination chain.
Example:
"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
Address that will fund the vault.
Example:
"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
Address that receives expiry refunds. Defaults to depositor.
Example:
"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
Response
Quoted vault created successfully
Show child attributes
Show child attributes