GET
/
v1
/
allchains
/
transactions
/
cURL
curl --request GET \
  --url https://api.covalenthq.com/v1/allchains/transactions/ \
  --header 'Authorization: Bearer <token>'
{
  "updated_at": "2023-11-07T05:31:56Z",
  "cursor_before": "<string>",
  "cursor_after": "<string>",
  "quote_currency": "<string>",
  "items": [
    {
      "block_height": 123,
      "block_signed_at": "2023-11-07T05:31:56Z",
      "block_hash": "<string>",
      "tx_hash": "<string>",
      "tx_offset": 123,
      "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_offered": 123,
      "gas_spent": 123,
      "gas_price": 123,
      "gas_quote": 123,
      "pretty_gas_quote": "<string>",
      "gas_quote_rate": 123,
      "fees_paid": "<string>",
      "gas_metadata": {
        "contract_decimals": 123,
        "contract_name": "<string>",
        "contract_ticker_symbol": "<string>",
        "contract_address": "<string>",
        "supports_erc": [
          "<string>"
        ],
        "logo_url": "<string>"
      },
      "successful": true,
      "chain_id": "<string>",
      "chain_name": "<string>",
      "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>"
              }
            ]
          }
        }
      ],
      "internal_transfers": [
        {
          "from_address": "<string>",
          "to_address": "<string>",
          "value": "<string>",
          "gas_limit": 123
        }
      ],
      "state_changes": [
        {
          "address": "<string>",
          "balance_before": "<string>",
          "balance_after": "<string>",
          "storage_changes": [
            {
              "storage_address": "<string>",
              "value_before": "<string>",
              "value_after": "<string>"
            }
          ],
          "nonce_before": 123,
          "nonce_after": 123
        }
      ],
      "input_data": {
        "method_id": "<string>"
      }
    }
  ]
}

Credit Cost

0.25 per item

Processing

Realtime
Base cost is 0.1 credits (e.g. requests that return with status 200 but no items).Calls without logs cost 0.1 credits/item.Calls with-logs costs 0.2 credits/item.Calls with-decoded-logs costs 0.25 credits/item.The following tracing features each cost 0.05 per transaction that they are available for:
  • with-internal - includes internal transfers/transactions.
  • with-state - includes all transaction state changes with before and after values.
  • with-input-data - includes the transaction’s input data such as the Method ID.
Currently, tracing features are supported on the following chains:
  • eth-mainnet
This Multichain & Multiaddress Transactions API is supported across all EVM chains. When no chains are specified, the Foundational Chains are passed as default.Domain names (e.g. demo.eth) are not supported.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
chains
string

Comma separated list of chain names or IDs to retrieve transactions from. Defaults to all foundational chains.

​
addresses
string

Comma separated list of addresses for which transactions are fetched.

​
limit
integer

Number of transactions to return per page, up to the default max of 100 items.

​
before
string

Pagination cursor pointing to fetch transactions before a certain point.

​
after
string

Pagination cursor pointing to fetch transactions after a certain point.

​
with-logs
boolean

Whether to include raw logs in the response.

​
with-decoded-logs
boolean

Whether to include decoded logs in the response.

​
with-internal
boolean

Whether to include internal transfers/transactions.

​
with-state
boolean

Whether to include all transaction state changes with before and after values.

​
with-input-data
boolean

Whether to include the transaction's input data such as the Method ID.

​
quote-currency
string

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

Response

200 - application/json

Successful response

​
updated_at
string<date-time>

Timestamp for when the data was last updated.

​
cursor_before
string

Pagination cursor pointing to the previous page.

​
cursor_after
string

Pagination cursor pointing to the next page.

​
quote_currency
string

The requested quote currency eg: USD.

​
items
object[]

List of transactions returned by the API.