GET
/
v1
/
{chainName}
/
address
/
{walletAddress}
/
transfers_v2
/
import { GoldRushClient } from "@covalenthq/client-sdk";

const ApiServices = async () => {
    const client = new GoldRushClient("YOUR_API_KEY");
    const resp = await client.BalanceService.getErc20TransfersForWalletAddress({chainName: "chainName", walletAddress: "walletAddress"});
    console.log(resp.data);
};

ApiServices();
{
  "address": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "quote_currency": "<string>",
  "chain_id": 123,
  "chain_name": "<string>",
  "items": [
    {
      "block_signed_at": "2023-11-07T05:31:56Z",
      "block_height": 123,
      "block_hash": "<string>",
      "tx_hash": "<string>",
      "tx_offset": 123,
      "successful": true,
      "miner_address": "<string>",
      "from_address": "<string>",
      "from_address_label": "<string>",
      "to_address": "<string>",
      "to_address_label": "<string>",
      "value": "<string>",
      "value_quote": 123,
      "pretty_value_quote": "<string>",
      "gas_metadata": {
        "contract_decimals": 123,
        "contract_name": "<string>",
        "contract_ticker_symbol": "<string>",
        "contract_address": "<string>",
        "supports_erc": [
          "<string>"
        ],
        "logo_url": "<string>"
      },
      "gas_offered": 123,
      "gas_spent": 123,
      "gas_price": 123,
      "fees_paid": "<string>",
      "gas_quote": 123,
      "pretty_gas_quote": "<string>",
      "gas_quote_rate": 123,
      "transfers": [
        {
          "block_signed_at": "2023-11-07T05:31:56Z",
          "tx_hash": "<string>",
          "from_address": "<string>",
          "from_address_label": "<string>",
          "to_address": "<string>",
          "to_address_label": "<string>",
          "contract_decimals": 123,
          "contract_name": "<string>",
          "contract_ticker_symbol": "<string>",
          "contract_address": "<string>",
          "logo_url": "<string>",
          "transfer_type": "<string>",
          "delta": "<string>",
          "balance": "<string>",
          "quote_rate": 123,
          "delta_quote": 123,
          "pretty_delta_quote": "<string>",
          "balance_quote": 123,
          "method_calls": [
            {
              "sender_address": "<string>",
              "method": "<string>"
            }
          ],
          "explorers": [
            {
              "label": "<string>",
              "url": "<string>"
            }
          ]
        }
      ]
    }
  ],
  "pagination": {
    "has_more": true,
    "page_number": 123,
    "page_size": 123,
    "total_count": 123
  }
}

Credit Cost

0.05 per item

Processing

Realtime

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form: Bearer <token>, where <token> is your GoldRush API Key.

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.

Query Parameters

​
quote-currency
string

The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP.

​
contract-address
string

The requested contract address. Passing in an ENS, RNS, Lens Handle, or an Unstoppable Domain resolves automatically.

​
starting-block
integer

The block height to start from, defaults to 0.

​
ending-block
integer

The block height to end at, defaults to current block height.

​
page-size
integer

Number of items per page. Omitting this parameter defaults to 100.

​
page-number
integer

0-indexed page number to begin pagination.

Response

200 - application/json

Successful response

​
address
string

The requested address.

​
updated_at
string

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.

​
items
object[]

List of response items.

​
pagination
object

Pagination metadata.