Check the status of a deposit
curl --request GET \
--url https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}import requests
url = "https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"data": {
"vaultAddress": "0x379BAB257e7Eb159538F01165B766A1BEaf2D954",
"amount": "1000000",
"deadline": 1789526504,
"state": "PENDING",
"intentHash": "0x3f1886e7c3a4cab62b4a0661e393600f0917d5a514652e96623b0f17ce0d3749",
"sourceChainId": 8453
}
}Circle Gateway fast deposits
Check the status of a deposit
Returns a deposit address’s state, quoted amount, deadline, and destination intent hash.
GET
/
v1
/
circle-gateway
/
deposit-addresses
/
{vaultAddress}
Check the status of a deposit
curl --request GET \
--url https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}import requests
url = "https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.eco.com/v1/circle-gateway/deposit-addresses/{vaultAddress}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"data": {
"vaultAddress": "0x379BAB257e7Eb159538F01165B766A1BEaf2D954",
"amount": "1000000",
"deadline": 1789526504,
"state": "PENDING",
"intentHash": "0x3f1886e7c3a4cab62b4a0661e393600f0917d5a514652e96623b0f17ce0d3749",
"sourceChainId": 8453
}
}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
Optional. A key that is unknown, revoked, or not enabled for v1 is rejected with 401.
Path Parameters
The vaultAddress returned when the deposit address was created.
EIP-55 / lowercase hex 20-byte address
Example:
"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
Query Parameters
The sourceChainId the deposit address was created for. Required; omitting it returns 400.
Example:
8453
Response
Quoted vault record retrieved successfully
Show child attributes
Show child attributes
