GET
/
v1
/
{chainName}
/
bulk
/
transactions
/
{walletAddress}
/
cURL
curl --request GET \
  --url https://api.covalenthq.com/v1/{chainName}/bulk/transactions/{walletAddress}/ \
  --header 'Authorization: Bearer <token>'
{
  "address": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "quote_currency": "<string>",
  "chain_id": 123,
  "chain_name": "<string>",
  "chain_tip_height": 123,
  "chain_tip_signed_at": "2023-11-07T05:31:56Z",
  "complete": true,
  "current_bucket": 123,
  "links": {
    "prev": "<string>",
    "next": "<string>"
  },
  "items": [
    {
      "block_signed_at": "2023-11-07T05:31:56Z",
      "block_height": 123,
      "block_hash": "<string>",
      "tx_hash": "<string>",
      "tx_offset": 123,
      "successful": true,
      "from_address": "<string>",
      "miner_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,
      "explorers": [
        {
          "label": "<string>",
          "url": "<string>"
        }
      ],
      "log_events": [
        {
          "block_signed_at": "2023-11-07T05:31:56Z",
          "block_height": 123,
          "tx_offset": 123,
          "log_offset": 123,
          "tx_hash": "<string>",
          "raw_log_topics": [
            "<string>"
          ],
          "sender_contract_decimals": 123,
          "sender_name": "<string>",
          "sender_contract_ticker_symbol": "<string>",
          "sender_address": "<string>",
          "sender_address_label": "<string>",
          "sender_logo_url": "<string>",
          "supports_erc": [
            "<string>"
          ],
          "sender_factory_address": "<string>",
          "raw_log_data": "<string>",
          "decoded": {
            "name": "<string>",
            "signature": "<string>",
            "params": [
              {
                "name": "<string>",
                "type": "<string>",
                "indexed": true,
                "decoded": true,
                "value": "<string>"
              }
            ]
          }
        }
      ]
    }
  ]
}

Credit Cost

0.1 per item

Processing

Realtime

Returns the same results as the first timebucket for an address in the Get recent transactions endpoint.

Requests that return status 200 and no data cost 0.1 credits.

Enabling no-logs reduces request cost to 0.05 per item.

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.

​
no-logs
boolean

Omit log events.

Response

200 - application/json

Successful response

The response is of type object.