---
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/`

Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address.

## 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.net/covalenthq/apis/goldrush-multichain-data-apis.md) · [All operations](https://skmtc.net/covalenthq/apis/goldrush-multichain-data-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/covalenthq/goldrush-multichain-data-apis/revisions/c099830c76a0/schema)