Jump to
Ctrl
+
/

List Transactions by Block Height

GET
/blockchain-data/{blockchain}/{network}/blocks/height/{height}/transactions

This endpoint will list transactions by an attribute blockHeight. The transactions listed will detail additional information such as hash, addresses, time of creation in Unix timestamp, etc.

Path Parameters

blockchain string Required

Represents the specific blockchain protocol name, e.g. Ethereum, Bitcoin, etc.

network string Required

Represents the name of the blockchain network used; blockchain networks are usually identical as technology and software, but they differ in data, e.g. - "mainnet" is the live network with actual data while networks like "testnet", "sepolia" are test networks.

height integer Required

Represents the number of blocks in the blockchain preceding this specific block. Block numbers have no gaps. A blockchain usually starts with block 0 called the "Genesis block".

Query Parameters

context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

limit integer Optional

Defines how many items should be returned in the response per page basis.

Default : 50
offset integer Optional

The starting index of the response items, i.e. where the response should start listing the returned items.

Default : 0

Response Schema

apiVersion string Required

Specifies the version of the API that incorporates this endpoint.

2021-03-20
requestId string Required

Defines the ID of the request. The requestId is generated by Crypto APIs and it's unique for every request.

601c1710034ed6d407996b30
context string Optional

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. context is specified by the user.

yourExampleString
data object Required
limit integer Required

Defines how many items should be returned in the response per page basis.

50
offset integer Required

The starting index of the response items, i.e. where the response should start listing the returned items.

0
total integer Required

Defines the total number of items returned in the response.

100
items array Items (object) Required
transactionId string Required

Represents the unique identifier of a transaction, i.e. it could be transactionId in UTXO-based protocols like Bitcoin, and transaction hash in Ethereum blockchain.

4b66461bf88b61e1e4326356534c135129defb504c7acb2fd6c92697d79eb250
index integer Required

Represents the index position of the transaction in the specific block.

2
minedInBlockHash string Required

Represents the hash of the block where this transaction was mined/confirmed for first time. The hash is defined as a cryptographic digital fingerprint made by hashing the block header twice through the SHA256 algorithm.

00000000407f119ecb74b44229228910400aaeb9f4e3b9869955b85a53e9b7db
minedInBlockHeight integer Required

Represents the hight of the block where this transaction was mined/confirmed for first time. The height is defined as the number of blocks in the blockchain preceding this specific block.

1939750
recipients array Items (object) Required

Represents a list of recipient addresses with the respective amounts. In account-based protocols like Ethereum there is only one address in this list.

address string Required

The address which receives this transaction. In UTXO-based protocols like Bitcoin there could be several senders while in account-based protocols like Ethereum there is always only one recipient.

2MzakdGTEp8SMWEHKwKM4HYv6uNCBXtHpkV
amount string Required

Represents the amount received to this address.

0.000144
senders array Items (object) Required

Represents a list of sender addresses with the respective amounts. In account-based protocols like Ethereum there is only one address in this list.

address string Required

Represents the address which sends this transaction. In UTXO-based protocols like Bitcoin there could be several senders while in account-based protocols like Ethereum there is always only one sender.

2N5PcdirZUzKF9bWuGdugNuzcQrCbBudxv1
amount string Required

Represents the total amount sent by this address including the fee.

0.00873472
timestamp integer Required

Defines the exact date/time in Unix Timestamp when this transaction was mined, confirmed or first seen in Mempool, if it is unconfirmed.

1582202940
transactionHash string Required

Represents the same as transactionId for account-based protocols like Ethereum, while it could be different in UTXO-based protocols like Bitcoin. E.g., in UTXO-based protocols hash is different from transactionId for SegWit transactions.

1ec73b0f61359927d02376b35993b756b1097cb9a857bec23da4c98c4977d2b2
fee object Required
amount string Required

Defines the amount of the fee.

0.00016932
unit string Required

Defines the specific unit of the fee.

BTC
blockchainSpecific object Required
locktime integer Required

Represents the time at which a particular transaction can be added to the blockchain.

1781965
size integer Required

Represents the total size of this transaction.

248
vSize integer Required

Represents the virtual size of this transaction.

166
version integer Required

Represents the transaction version number.

1
vin array Items (object) Required

Represents the transaction inputs.

addresses array Items (string) Required
coinbase string Required

Represents the coinbase hex.

0399991d20706f6f6c2e656e6a6f79626f646965732e636f6d20393963336532346234374747a53e994c4a000001
scriptSig object Required

Specifies the required signatures.

asm string Required

The asm strands for assembly, which is the symbolic representation of the Bitcoin's Script language op-codes.

0014daaf6d5cb86befe42df851a4d1df052e663754c1
hex string Required

Represents the hex of the public key of the address.

160014daaf6d5cb86befe42df851a4d1df052e663754c1
type string Required

Represents the script type of the reference transaction identifier.

scripthash
sequence string Required

Represents the script sequence number.

4294967295
txid string Required

Represents the reference transaction identifier.

caee978cae255bbe303ac86152679e46113a8b12925aa3afaa312d89d11ccbf8
txinwitness array Items (string) Required
value string Required

Represents the sent/received amount.

0.00873472
vout integer Required

It refers to the index of the output address of this transaction. The index starts from 0.

1
vout array Items (object) Required

Represents the transaction outputs.

isSpent boolean Required

Defines whether the output is spent or not.

true
scriptPubKey object Required

Represents the script public key.

addresses array Items (string) Required
asm string Required

Represents the assembly of the script public key of the address.

OP_HASH160 507a5bd8cac1d9efdf4c0a4bfacb3e0abb4f8d15 OP_EQUAL
hex string Required

Represents the hex of the script public key of the address.

a914507a5bd8cac1d9efdf4c0a4bfacb3e0abb4f8d1587
reqSigs integer Optional

Represents the required signatures.

2
type string Required

Represents the script type.

scripthash
value string Required

Represents the sent/received amount.

0.000144

Credits Cost : 100 Credits for 1 Results

Was this page helpful?
Yes
No
Language
URL

{
    "apiVersion": "2021-03-20",
    "requestId": "601c1710034ed6d407996b30",
    "context": "yourExampleString",
    "data": {
        "limit": 50,
        "offset": 0,
        "total": 100,
        "items": [
            {
                "transactionId": "4b66461bf88b61e1e4326356534c135129defb504c7acb2fd6c92697d79eb250",
                "index": 2,
                "minedInBlockHash": "00000000407f119ecb74b44229228910400aaeb9f4e3b9869955b85a53e9b7db",
                "minedInBlockHeight": 1939750,
                "recipients": [
                    {
                        "address": "2MzakdGTEp8SMWEHKwKM4HYv6uNCBXtHpkV",
                        "amount": "0.000144"
                    }
                ],
                "senders": [
                    {
                        "address": "2N5PcdirZUzKF9bWuGdugNuzcQrCbBudxv1",
                        "amount": "0.00873472"
                    }
                ],
                "timestamp": 1582202940,
                "transactionHash": "1ec73b0f61359927d02376b35993b756b1097cb9a857bec23da4c98c4977d2b2",
                "fee": {
                    "amount": "0.00016932",
                    "unit": "BTC"
                },
                "blockchainSpecific": {
                    "locktime": 1781965,
                    "size": 248,
                    "vSize": 166,
                    "version": 1,
                    "vin": [
                        {
                            "addresses": [
                                "2N5PcdirZUzKF9bWuGdugNuzcQrCbBudxv1"
                            ],
                            "coinbase": "0399991d20706f6f6c2e656e6a6f79626f646965732e636f6d20393963336532346234374747a53e994c4a000001",
                            "scriptSig": {
                                "asm": "0014daaf6d5cb86befe42df851a4d1df052e663754c1",
                                "hex": "160014daaf6d5cb86befe42df851a4d1df052e663754c1",
                                "type": "scripthash"
                            },
                            "sequence": "4294967295",
                            "txid": "caee978cae255bbe303ac86152679e46113a8b12925aa3afaa312d89d11ccbf8",
                            "txinwitness": [
                                "3045022100c11ea5740bcd69f0f68a4914279838014d28923134d18e05c5a5486dfd06cc8c02200dadccec3f07bed0d1040f9e5a155efa5fdd40fc91f92342578d26848da4c6b901"
                            ],
                            "value": "0.00873472",
                            "vout": 1
                        }
                    ],
                    "vout": [
                        {
                            "isSpent": true,
                            "scriptPubKey": {
                                "addresses": [
                                    "2N5PcdirZUzKF9bWuGdugNuzcQrCbBudxv1"
                                ],
                                "asm": "OP_HASH160 507a5bd8cac1d9efdf4c0a4bfacb3e0abb4f8d15 OP_EQUAL",
                                "hex": "a914507a5bd8cac1d9efdf4c0a4bfacb3e0abb4f8d1587",
                                "reqSigs": 2,
                                "type": "scripthash"
                            },
                            "value": "0.000144"
                        }
                    ]
                }
            }
        ]
    }
}