GET
/
v1
/
{chainName}
/
bulk
/
transactions
/
{walletAddress}
/
{timeBucket}
/
curl --request GET \
  --url https://api.covalenthq.com/v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/ \
  --header 'Authorization: Bearer <token>'
{
  "address": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "quote_currency": "<string>",
  "chain_id": 123,
  "chain_name": "<string>",
  "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

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.

​
timeBucket
integer
required

The 0-indexed 15-minute time bucket. E.g. 27 Feb 2023 05:23 GMT = 1677475383 (Unix time). 1677475383/900=1863861 timeBucket.

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.