Skip to main content
Version: 1.4

Covalent

Covalent provides a unified API to bring full transparency and visibility to assets across all blockchain networks including Godwoken.

To get started, sign up for an API Key.

Developer Mode (JSON)Analyst Mode (CSV)
Developer ModeAnalyst Mode

The Covalent API is RESTful and offers the following out-of-the-box for Godwoken:

Covalent API
Response formatsJSON and CSV
Real time response2 blocks
Batch response30 minutes
Request volume limitNone
Request rate limit5 requests per second
Base URLhttps://api.covalenthq.com/v1
Networks & chain_idMainnet - 71402
Testnet - 71401
Supported EndpointsClass 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/71402/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 = 71402
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 = 71402
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:

GamingDeFiKYCNFT
GamingDeFi TaxesKYCNFTs
WalletsDashboardsOn-Chain ForensicsDAO
WalletsDashboardsOn-Chain ForensicsDAO Data
TradingPredictionsGovernancePricing
DEXs & TradingPredictive AnalyticsGovernancePricing

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 32+ blockchains. Covalent is trusted by a community of 27,000+ developers and powers data for 1000+ applications including 0x, Zerion, Rainbow Wallet, Rotki, Bitski and many others.

Website | Discord | Telegram | Twitter | Youtube | 微信公众号