namillum
Version:
Bubble Protocol SDK
106 lines (89 loc) • 4.15 kB
Markdown
---
id: api-transaction-get-txbodies-for-txblock-ex
title: GetTxnBodiesForTxBlockEx
---
---
This API behaves similar to
[GetTxBodiesForTxBlock](api-transaction-get-txbodies-for-txblock.md) except it
returns the transactions in batches (or pages) of 2,500.
The number of pages available is defined by the `NumPages` header value in the
[GetTxBlock](../blockchain-related-methods/api-blockchain-get-tx-block.md) or
[GetLatestTxBlock](../blockchain-related-methods/api-blockchain-get-latest-tx-block.md) response. Page
indexing is zero-based and indicated in the request after the block number.
For example, to retrieve all the transactions for a block with `NumPages=3`, one
must call `GetTxBodiesForTxBlockEx` three times with page number 0, 1, and 2.
This API is available from Zilliqa `V7.2.0` onwards.
### Example Request
=== "cURL"
```shell
curl -d '{
"id": "1",
"jsonrpc": "2.0",
"method": "GetTxnBodiesForTxBlockEx",
"params": ["1002353", "2"]
}' -H "Content-Type: application/json" -X POST "https://api.zilliqa.com/"
```
### Example Response
```json
{
"id": "1",
"jsonrpc": "2.0",
"result": {
"CurrPage": 2,
"NumPages": 5,
"Transactions": [
{
"ID": "0a9b4733bff6be2d48020f42e561a89d735eeb809eda257b6a56712223e842eb",
"amount": "0",
"gasLimit": "1",
"gasPrice": "2000000000",
"nonce": "96538",
"receipt": {
"cumulative_gas": "1",
"epoch_num": "1002353",
"success": true
},
"senderPubKey": "0x0235372F21184432428ABCDF99385FFF3A4EC346942B51FACBE9589DDF482C5D45",
"signature": "0x1A7CD80504D1BD75C50F751C08FC36ACC0F1A94852048179BCC927A3D5BC297AF01FB0A9CADBEC9AB870D330C8E2931E7025AE1293CE66B7429ABC44E785F16B",
"toAddr": "43b358e23092e2d367cedcd08c513fdca2162c01",
"version": "65537"
},
...{
"ID": "d116b78ddd5a30bc1a27495f9227af1cd62a90766eaaba7610a395aeab78ee10",
"amount": "0",
"gasLimit": "1",
"gasPrice": "2000000000",
"nonce": "98068",
"receipt": {
"cumulative_gas": "1",
"epoch_num": "1002353",
"success": true
},
"senderPubKey": "0x02FBB56136F2BBC10C963CCB8FA19287926A655023AB137BB018D2C65238D0F481",
"signature": "0xC6C4B4060026631F6F79BB5D6B163A51729E11A92D0E217F3ABCD38D2A8E733C62A9EBADA184DEAD5859BBE68ABD888E3A0B194B260FF7A9ACD58523A37EF896",
"toAddr": "43b358e23092e2d367cedcd08c513fdca2162c01",
"version": "65537"
}
]
}
}
```
### HTTP Request
| Chain(s) | URL(s) |
| --------------------- | -------------------------------------------------------------------------------------------- |
| **Zilliqa mainnet** | [https://api.zilliqa.com/](https://api.zilliqa.com/) |
| **Developer testnet** | [https://dev-api.zilliqa.com/](https://dev-api.zilliqa.com/) |
| **Local testnet** | [http://localhost:4201/](http://localhost:4201/) |
| **Isolated server** | [https://zilliqa-isolated-server.zilliqa.com/](https://zilliqa-isolated-server.zilliqa.com/) |
### Arguments
| Parameter | Type | Required | Description |
| --------- | ------ | -------- | ---------------------------- |
| `id` | string | Required | `"1"` |
| `jsonrpc` | string | Required | `"2.0"` |
| `method` | string | Required | `"GetTxnBodiesForTxBlockEx"` |
| `params` | array | Required | Block parameters |
### Block Parameters
| Parameter | Type | Required | Description |
| -------------- | ------ | -------- | -------------------------------------------------------- |
| `Block number` | string | Required | Specifed TX block number to return. Example: `"1002353"` |
| `Page number` | string | Required | Page number (zero-based). Example: `"2"` |