--- title: "GET /v1/{chainName}/address/{walletAddress}/transfers_v2/" method: GET path: "/v1/{chainName}/address/{walletAddress}/transfers_v2/" tags: ["get-erc20-token-transfers-for-address"] --- # GET /v1/{chainName}/address/{walletAddress}/transfers_v2/ `GET /v1/{chainName}/address/{walletAddress}/transfers_v2/` ## Request - Base URL: `https://api.covalenthq.com` - URL: `https://api.covalenthq.com/v1/{chainName}/address/{walletAddress}/transfers_v2/` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns the transfer-in and transfer-out of a token for an address, along with historical prices. ## Path parameters - `chainName` string, required - `walletAddress` string, required ## Query parameters - `quote-currency` string - `contract-address` string, required - `starting-block` integer - `ending-block` integer - `page-size` integer - `page-number` integer ## Response `200` Successful response - object - `address` string: The requested address. - `updated_at` string, date-time: The timestamp when the response was generated. Useful to show data staleness to users. - `quote_currency` string: The requested quote currency eg: `USD`. - `chain_id` integer: The requested chain ID eg: `1`. - `chain_name` string: The requested chain name eg: `eth-mainnet`. - `chain_tip_height` integer: The latest block height of the blockchain at the time this response was provided. - `chain_tip_signed_at` string, date-time: The timestamp of the latest signed block at the time this response was provided. - `items` object[]: List of response items. - `block_signed_at` string, date-time: The block signed timestamp in UTC. - `block_height` integer: The height of the block. - `block_hash` string: The hash of the block. Use it to remove transactions from re-org-ed blocks. - `tx_hash` string: The requested transaction hash. - `tx_offset` integer: The offset is the position of the tx in the block. - `successful` boolean: Whether or not transaction is successful. - `miner_address` string: The address of the miner. - `from_address` string: The sender's wallet address. - `to_address` string: The receiver's wallet address. - `value` string: b;The value attached to this tx. - `value_quote` number, double: The value attached in `quote-currency` to this tx. - `pretty_value_quote` string: A prettier version of the quote for rendering purposes. - `gas_metadata` object: The requested chain native gas token metadata. - `contract_decimals` integer: Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`. - `contract_name` string: The string returned by the `name()` method. - `contract_ticker_symbol` string: The ticker symbol for this contract. This field is set by a developer and non-unique across a network. - `contract_address` string: Use the relevant `contract_address` to lookup prices, logos, token transfers, etc. - `supports_erc` string[]: A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`. - `logo_url` string: The contract logo URL. - `gas_offered` integer - `gas_spent` integer: The gas spent for this tx. - `gas_price` integer: The gas price at the time of this tx. - `fees_paid` string: b;The transaction's gas_price * gas_spent, denoted in wei. - `gas_quote` number, double: The gas spent in `quote-currency` denomination. - `pretty_gas_quote` string: A prettier version of the quote for rendering purposes. - `gas_quote_rate` number, double: The native gas exchange rate for the requested `quote-currency`. - `transfers` object[] - `block_signed_at` string, date-time: The block signed timestamp in UTC. - `tx_hash` string: The requested transaction hash. - `from_address` string: The sender's wallet address. - `to_address` string: The receiver's wallet address. - `contract_decimals` integer: Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`. - `contract_name` string: The string returned by the `name()` method. - `contract_ticker_symbol` string: The ticker symbol for this contract. This field is set by a developer and non-unique across a network. - `contract_address` string: Use the relevant `contract_address` to lookup prices, logos, token transfers, etc. - `logo_url` string: The contract logo URL. - `transfer_type` string: Categorizes token transactions as either `transfer-in` or `transfer-out`, indicating whether tokens are being received or sent from an account. - `delta` string: b;The delta attached to this transfer. - `balance` string: b;The asset balance. Use `contract_decimals` to scale this balance for display purposes. - `quote_rate` number, double: The exchange rate for the requested quote currency. - `delta_quote` number, double: The current delta converted to fiat in `quote-currency`. - `pretty_delta_quote` string: A prettier version of the quote for rendering purposes. - `balance_quote` number, double: The current balance converted to fiat in `quote-currency`. - `method_calls` object[]: Additional details on which transfer events were invoked. Defaults to `true`. - `sender_address` string: The address of the sender. - `method` string - `explorers` object[]: The explorer links for this transaction. - `label` string: The name of the explorer. - `url` string: The URL of the explorer. - `pagination` object: Pagination metadata. - `has_more` boolean: True if there is another page. - `page_number` integer: The requested page number. - `page_size` integer: The requested number of items on the current page. - `total_count` integer: The total number of items across all pages for this request. --- [API](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis.md) - [All operations](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/goldrush/apis/goldrush-multichain-data-apis/revisions/31713d2c30bc?raw)