Path Parameters
- chainNamestringREQUIRED
The chain name eg: eth-mainnet
- walletAddressstringREQUIRED
The requested address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically
Returns
- dataobject
The response data containing details of the wallet and its token approvals
- addressstring
The wallet address associated with the approvals
- updated_atstring
The timestamp of the last update for the data
- quote_currencystring
The currency in which the balances and risks are quoted
- chain_idinteger
The ID of the blockchain network queried
- chain_namestring
The name of the blockchain network queried
- itemsarray
A list of token approval details for the wallet address
- token_addressstring
The contract address of the token
- token_address_labelstring
The label or name of the token contract
- ticker_symbolstring
The ticker symbol of the token
- contract_decimalsinteger
The number of decimals for the token
- logo_urlstring
The URL for the token's logo
- quote_ratenumber
The quoted rate of the token in the specified currency
- balancestring
The token balance in raw format
- balance_quotenumber
The balance value quoted in the specified currency
- pretty_balance_quotestring
The balance value in a human-readable format
- value_at_riskstring
The amount of token value at risk
- value_at_risk_quotenumber
The value at risk quoted in the specified currency
- pretty_value_at_risk_quotestring
The value at risk in a human-readable format
- spendersarray
A list of spenders who have approvals for the token
- block_heightinteger
The height of the block where the approval occurred
- tx_offsetinteger
The transaction offset in the block
- log_offsetinteger
The log offset in the transaction
- block_signed_atstring
The timestamp when the block was signed
- tx_hashstring
The hash of the transaction where the approval occurred
- spender_addressstring
The address of the spender with token approval
- spender_address_labelstring
The label for the spender address, if available
- allowancestring
The allowance granted to the spender
- allowance_quotenumber
The quoted allowance value in the specified currency
- pretty_allowance_quotestring
The quoted allowance value in a human-readable format
- value_at_riskstring
The token value at risk due to the spender
- value_at_risk_quotenumber
The value at risk quoted in the specified currency
- pretty_value_at_risk_quotestring
The value at risk in a human-readable format
- risk_factorstring
The risk level associated with the token approval
- errorboolean
Indicates whether an error occurred
- error_messagestring
The error message if an error occurred, or null otherwise
- error_codestring
The error code if an error occurred, or null otherwise
1{2"data": {3"address": "0x8526E4F21d060Ef0EF2e69D2a00392e82eeFa63D",4"updated_at": "2025-04-30T12:34:56Z",5"quote_currency": "USD",6"chain_id": 1,7"chain_name": "eth-mainnet",8"items": [9{10"token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",11"token_address_label": "USD Coin",12"ticker_symbol": "USDC",13"contract_decimals": 6,14"logo_url": "https://logos.covalenthq.com/tokens/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.png",15"quote_rate": 1,16"balance": "5000000000",17"balance_quote": 5000,18"pretty_balance_quote": "$5,000.00",19"value_at_risk": "5000000000",20"value_at_risk_quote": 5000,21"pretty_value_at_risk_quote": "$5,000.00",22"spenders": [23{24"block_height": 18641243,25"tx_offset": 45,26"log_offset": 78,27"block_signed_at": "2025-04-15T09:23:12Z",28"tx_hash": "0x3a7e2342a9b45c3e02d1f731c65487b4c5a82e234d8a76f1d5e5c6e7d8a9b0c1",29"spender_address": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",30"spender_address_label": "Uniswap V2: Router 2",31"allowance": "115792089237316195423570985008687907853269984665640564039457584007913129639935",32"allowance_quote": 1.157920892373162e+77,33"pretty_allowance_quote": "$115,792,089,237,316,195,423,570,985,008,687,907,853,269,984,665,640,564,039,457,584,007,913,129,639,935.00",34"value_at_risk": "5000000000",35"value_at_risk_quote": 5000,36"pretty_value_at_risk_quote": "$5,000.00",37"risk_factor": "high"38}39]40},41{42"token_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",43"token_address_label": "Tether USD",44"ticker_symbol": "USDT",45"contract_decimals": 6,46"logo_url": "https://logos.covalenthq.com/tokens/0xdac17f958d2ee523a2206206994597c13d831ec7.png",47"quote_rate": 1,48"balance": "2500000000",49"balance_quote": 2500,50"pretty_balance_quote": "$2,500.00",51"value_at_risk": "2500000000",52"value_at_risk_quote": 2500,53"pretty_value_at_risk_quote": "$2,500.00",54"spenders": [55{56"block_height": 18623456,57"tx_offset": 12,58"log_offset": 25,59"block_signed_at": "2025-04-10T14:56:32Z",60"tx_hash": "0x4b8c2d3e45f6a7b890c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3",61"spender_address": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",62"spender_address_label": "Uniswap V3: Router",63"allowance": "115792089237316195423570985008687907853269984665640564039457584007913129639935",64"allowance_quote": 1.157920892373162e+77,65"pretty_allowance_quote": "$115,792,089,237,316,195,423,570,985,008,687,907,853,269,984,665,640,564,039,457,584,007,913,129,639,935.00",66"value_at_risk": "2500000000",67"value_at_risk_quote": 2500,68"pretty_value_at_risk_quote": "$2,500.00",69"risk_factor": "high"70}71]72}73]74},75"error": false,76"error_message": null,77"error_code": null78}
1{2"data": {3"address": "0x8526E4F21d060Ef0EF2e69D2a00392e82eeFa63D",4"updated_at": "2025-04-30T12:34:56Z",5"quote_currency": "USD",6"chain_id": 1,7"chain_name": "eth-mainnet",8"items": [9{10"token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",11"token_address_label": "USD Coin",12"ticker_symbol": "USDC",13"contract_decimals": 6,14"logo_url": "https://logos.covalenthq.com/tokens/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.png",15"quote_rate": 1,16"balance": "5000000000",17"balance_quote": 5000,18"pretty_balance_quote": "$5,000.00",19"value_at_risk": "5000000000",20"value_at_risk_quote": 5000,21"pretty_value_at_risk_quote": "$5,000.00",22"spenders": [23{24"block_height": 18641243,25"tx_offset": 45,26"log_offset": 78,27"block_signed_at": "2025-04-15T09:23:12Z",28"tx_hash": "0x3a7e2342a9b45c3e02d1f731c65487b4c5a82e234d8a76f1d5e5c6e7d8a9b0c1",29"spender_address": "0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",30"spender_address_label": "Uniswap V2: Router 2",31"allowance": "115792089237316195423570985008687907853269984665640564039457584007913129639935",32"allowance_quote": 1.157920892373162e+77,33"pretty_allowance_quote": "$115,792,089,237,316,195,423,570,985,008,687,907,853,269,984,665,640,564,039,457,584,007,913,129,639,935.00",34"value_at_risk": "5000000000",35"value_at_risk_quote": 5000,36"pretty_value_at_risk_quote": "$5,000.00",37"risk_factor": "high"38}39]40},41{42"token_address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",43"token_address_label": "Tether USD",44"ticker_symbol": "USDT",45"contract_decimals": 6,46"logo_url": "https://logos.covalenthq.com/tokens/0xdac17f958d2ee523a2206206994597c13d831ec7.png",47"quote_rate": 1,48"balance": "2500000000",49"balance_quote": 2500,50"pretty_balance_quote": "$2,500.00",51"value_at_risk": "2500000000",52"value_at_risk_quote": 2500,53"pretty_value_at_risk_quote": "$2,500.00",54"spenders": [55{56"block_height": 18623456,57"tx_offset": 12,58"log_offset": 25,59"block_signed_at": "2025-04-10T14:56:32Z",60"tx_hash": "0x4b8c2d3e45f6a7b890c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3",61"spender_address": "0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45",62"spender_address_label": "Uniswap V3: Router",63"allowance": "115792089237316195423570985008687907853269984665640564039457584007913129639935",64"allowance_quote": 1.157920892373162e+77,65"pretty_allowance_quote": "$115,792,089,237,316,195,423,570,985,008,687,907,853,269,984,665,640,564,039,457,584,007,913,129,639,935.00",66"value_at_risk": "2500000000",67"value_at_risk_quote": 2500,68"pretty_value_at_risk_quote": "$2,500.00",69"risk_factor": "high"70}71]72}73]74},75"error": false,76"error_message": null,77"error_code": null78}