Skip to main content

v1/{chainName}/approvals/{walletAddress}/ REST API Endpoint

Commonly used to get a list of approvals across all token contracts categorized by spenders for a wallet’s assets.

Updated on
Jan 09, 2025

v1/{chainName}/approvals/{walletAddress}/ REST API Endpoint

Path Parameters

chainName
string
REQUIRED
The chain name eg: eth-mainnet
walletAddress
string
REQUIRED
The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically

Returns

data
object
The response data containing details of the wallet and its token approvals
address
string
The wallet address associated with the approvals
updated_at
string
The timestamp of the last update for the data
quote_currency
string
The currency in which the balances and risks are quoted
chain_id
integer
The ID of the blockchain network queried
chain_name
string
The name of the blockchain network queried
items
array
A list of token approval details for the wallet address
token_address
string
The contract address of the token
token_address_label
string
The label or name of the token contract
ticker_symbol
string
The ticker symbol of the token
contract_decimals
integer
The number of decimals for the token
logo_url
string
The URL for the token's logo
quote_rate
number
The quoted rate of the token in the specified currency
balance
string
The token balance in raw format
balance_quote
number
The balance value quoted in the specified currency
pretty_balance_quote
string
The balance value in a human-readable format
value_at_risk
string
The amount of token value at risk
value_at_risk_quote
number
The value at risk quoted in the specified currency
pretty_value_at_risk_quote
string
The value at risk in a human-readable format
spenders
array
A list of spenders who have approvals for the token
block_height
integer
The height of the block where the approval occurred
tx_offset
integer
The transaction offset in the block
log_offset
integer
The log offset in the transaction
block_signed_at
string
The timestamp when the block was signed
tx_hash
string
The hash of the transaction where the approval occurred
spender_address
string
The address of the spender with token approval
spender_address_label
string
The label for the spender address, if available
allowance
string
The allowance granted to the spender
allowance_quote
number
The quoted allowance value in the specified currency
pretty_allowance_quote
string
The quoted allowance value in a human-readable format
value_at_risk
string
The token value at risk due to the spender
value_at_risk_quote
number
The value at risk quoted in the specified currency
pretty_value_at_risk_quote
string
The value at risk in a human-readable format
risk_factor
string
The risk level associated with the token approval
error
boolean
Indicates whether an error occurred
error_message
string
The error message if an error occurred, or null otherwise
error_code
string
The error code if an error occurred, or null otherwise
Request
1
curl --location 'https://api.covalenthq.com/v1/eth-mainnet/approvals/0x8526E4F21d060Ef0EF2e69D2a00392e82eeFa63D/' \
2
--header 'Content-Type: application/json' \
3
--header 'Authorization: Bearer YOUR_API_KEY'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free