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.