COVALENT
Covalent
Covalent provides a unified API to bring full transparency and visibility to assets across all blockchain networks including Gather.
To get started, sign up for an API Key.
Developer Mode (JSON)
Analyst Mode (CSV)
The Covalent API is RESTful and offers the following out-of-the-box for Gather:
Covalent API
Response formats
JSON and CSV
Real time response
2 blocks
Batch response
30 minutes
Request volume limit
None
Request rate limit
5 requests per second
Base URL
https://api.covalenthq.com/v1/
Networks & chain_id
Mainnet - 192837465
Testnet - 356256156
Supported Endpoints
Class A - Balances - Transactions - Transfers - Token Holders - Log Events (Contract Address) - Log Events (Topic Hash)
Try the supported endpoints directly in your browser from our API Reference or use the following code examples. The JSON response format is the same for all endpoints:
❴
"data": ...,
"error": false,
"error_message": null,
"error_code": null
❵Curl
curl -X GET "https://api.covalenthq.com/v1/192837465/address/0xFEC4f9D5B322Aa834056E85946A32c35A3f5aDD8/balances_v2/?key={YOUR API KEY}" -H "Accept: application/json"
JavaScript
const APIKEY = 'YOUR API KEY';
const baseURL = 'https://api.covalenthq.com/v1'
const blockchainId = 192837465
const demoAddress = '0xFEC4f9D5B322Aa834056E85946A32c35A3f5aDD8'
async function getWalletBalance(chainId, address) {
const url = new URL(`${baseURL}/${chainId}/address/${address}/balances_v2/?key=${APIKEY}`);
const response = await fetch(url);
const result = await response.json();
const data = result.data;
console.log(data)
return data;
}
// Example address request
getWalletBalance(blockchainId, demoAddress);Python
import requests
API_KEY = 'YOUR API KEY'
base_url = 'https://api.covalenthq.com/v1'
blockchain_id = 192837465
demo_address = '0xFEC4f9D5B322Aa834056E85946A32c35A3f5aDD8'
def get_wallet_balance(chain_id, address):
endpoint = f'/{chain_id}/address/{address}/balances_v2/?key={API_KEY}'
url = base_url + endpoint
result = requests.get(url).json()
data = result["data"]
print(data)
return(data)
# Example address request
get_wallet_balance(blockchain_id, demo_address)
Use Cases
The Covalent API supports a broad range of Web3 data use cases including:
Gaming
DeFi Taxes
KYC
NFTs
Wallets
Dashboards
On-Chain Forensics
DAO Data
DEXs & Trading
Predictive Analytics
Governance
Pricing
Check out our collection of ready-to-ship Code Templates that you can use to build your Web3 data-powered dApps.
Resources
Here are some additional resources to help you get started with the Covalent API:
About Covalent
Covalent provides the industry-leading Unified API bringing visibility to billions of Web3 data points. Developers use Covalent to build exciting multi-chain applications like crypto wallets, NFT galleries, and investor dashboard tools utilizing data from 40+ blockchains. Covalent is trusted by a community of 35,000+ developers and powers data for 3000+ applications including 0x, Zerion, Rainbow Wallet, Rotki, Bitski and many others.
Last updated