Get bulk time bucket transactions for address (v3)

cURL

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>",
  "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>"
              }
            ]
          }
        }
      ]
    }
  ]
}

GET

{chainName}

bulk

transactions

{walletAddress}

{timeBucket}

cURL

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>",
  "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

Requests that return status 200 and no data cost 0.1 credits.Enabling no-logs reduces request cost to 0.05 per item.

Related guides

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

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.

complete

boolean

current_bucket

integer

The current bucket of the response.

links

object

Show child attributes

links.prev

string

URL link to the next page.

links.next

string

URL link to the previous page.

items

object[]

List of response items.

Show child attributes

items.block_signed_at

string<date-time>

The block signed timestamp in UTC.

items.block_height

integer

The height of the block.

items.block_hash

string

The hash of the block. Use it to remove transactions from re-org-ed blocks.

items.tx_hash

string

The requested transaction hash.

items.tx_offset

integer

The offset is the position of the tx in the block.

items.successful

boolean

Indicates whether a transaction failed or succeeded.

items.from_address

string

The sender's wallet address.

items.miner_address

string

The address of the miner.

items.from_address_label

string

The label of from address.

items.to_address

string

The receiver's wallet address.

items.to_address_label

string

The label of to address.

items.value

string

b;The value attached to this tx.

items.value_quote

number<double>

The value attached in quote-currency to this tx.

items.pretty_value_quote

string

A prettier version of the quote for rendering purposes.

items.gas_metadata

object

The requested chain native gas token metadata.

Show child attributes

items.gas_metadata.contract_decimals

integer

Use contract decimals to format the token balance for display purposes - divide the balance by 10^{contract_decimals}.

items.gas_metadata.contract_name

string

The string returned by the name() method.

items.gas_metadata.contract_ticker_symbol

string

The ticker symbol for this contract. This field is set by a developer and non-unique across a network.

items.gas_metadata.contract_address

string

Use the relevant contract_address to lookup prices, logos, token transfers, etc.

items.gas_metadata.supports_erc

string[]

A list of supported standard ERC interfaces, eg: ERC20 and ERC721.

items.gas_metadata.logo_url

string

The contract logo URL.

items.gas_offered

integer<int64>

items.gas_spent

integer<int64>

The gas spent for this tx.

items.gas_price

integer<int64>

The gas price at the time of this tx.

items.fees_paid

string

b;The total transaction fees (gas_price * gas_spent) paid for this tx, denoted in wei.

items.gas_quote

number<double>

The gas spent in quote-currency denomination.

items.pretty_gas_quote

string

A prettier version of the quote for rendering purposes.

items.gas_quote_rate

number<double>

The native gas exchange rate for the requested quote-currency.

items.explorers

object[]

The explorer links for this transaction.

Show child attributes

items.explorers.label

string

The name of the explorer.

items.explorers.url

string

The URL of the explorer.

items.log_events

object[]

The log events.

Show child attributes

items.log_events.block_signed_at

string<date-time>

The block signed timestamp in UTC.

items.log_events.block_height

integer<int64>

The height of the block.

items.log_events.tx_offset

integer<int64>

The offset is the position of the tx in the block.

items.log_events.log_offset

integer<int64>

The offset is the position of the log entry within an event log.

items.log_events.tx_hash

string

The requested transaction hash.

items.log_events.raw_log_topics

string[]

The log topics in raw data.

items.log_events.sender_contract_decimals

integer

Use contract decimals to format the token balance for display purposes - divide the balance by 10^{contract_decimals}.

items.log_events.sender_name

string

The name of the sender.

items.log_events.sender_contract_ticker_symbol

string

items.log_events.sender_address

string

The address of the sender.

items.log_events.sender_address_label

string

The label of the sender address.

items.log_events.sender_logo_url

string

The contract logo URL.

items.log_events.supports_erc

string[]

A list of supported standard ERC interfaces, eg: ERC20 and ERC721.

items.log_events.sender_factory_address

string

The address of the deployed UniswapV2 like factory contract for this DEX.

items.log_events.raw_log_data

string

The log events in raw.

items.log_events.decoded

object

The decoded item.

Show child attributes

items.log_events.decoded.name

string

items.log_events.decoded.signature

string

items.log_events.decoded.params

object[]

Show child attributes

items.log_events.decoded.params.name

string

items.log_events.decoded.params.type

string

items.log_events.decoded.params.indexed

boolean

items.log_events.decoded.params.decoded

boolean

items.log_events.decoded.params.value

string

Get paginated transactions for address (v3)Get all transactions in a block by page (v3)

⌘I

GoldRush Foundational API

API Reference

Resources

Get bulk time bucket transactions for address (v3)

Credit Cost

Processing

Authorizations

Path Parameters

Query Parameters

Response