Get all transactions in a block (v3)

Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.

GET /v1/{chainName}/block_hash/{blockHash}/transactions_v3/

GoldRush SDK

TypeScript

import { GoldRushClient } from "@covalenthq/client-sdk";

const ApiServices = async () => {
    const client = new GoldRushClient("<GOLDRUSH_API_KEY>");
    const resp = await client.TransactionService.getTransactionsForBlockHash({chainName: "chainName", walletAddress: "walletAddress"});
    console.log(resp.data);
};

ApiServices();

curl --request GET \
  --url https://api.covalenthq.com/v1/{chainName}/block_hash/{blockHash}/transactions_v3/ \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.covalenthq.com/v1/{chainName}/block_hash/{blockHash}/transactions_v3/"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.covalenthq.com/v1/{chainName}/block_hash/{blockHash}/transactions_v3/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.covalenthq.com/v1/{chainName}/block_hash/{blockHash}/transactions_v3/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.covalenthq.com/v1/{chainName}/block_hash/{blockHash}/transactions_v3/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.covalenthq.com/v1/{chainName}/block_hash/{blockHash}/transactions_v3/")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.covalenthq.com/v1/{chainName}/block_hash/{blockHash}/transactions_v3/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

200

{
  "updated_at": "2023-11-07T05:31:56Z",
  "chain_id": 123,
  "chain_name": "<string>",
  "chain_tip_height": 123,
  "chain_tip_signed_at": "2023-11-07T05:31:56Z",
  "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>",
      "to_address": "<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_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
        }
      ]
    }
  ]
}

Credit Cost

0.1 per item

Processing

Realtime

Estimate your monthly cost for this API using the Pricing Calculator.

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

Enabling no-logs reduces request cost to 0.05 credits/item.

Related guides

Introducing Transactions V3 APIs

Comparing GoldRush’s Transactions API to RPC Providers

How to Track Wallets or Transactions with the GoldRush API

How to Get the Number of Transactions in a Block

How to Get All Historical Transactions in a Block

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.

blockHash · string · required

The requested block hash.

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

updated_at · string<date-time>

The timestamp when the response was generated. Useful to show data staleness to users.

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.

items · object[]

List of response items.

Show child attributes