namillum
Version:
Bubble Protocol SDK
115 lines (94 loc) • 3.97 kB
text/mdx
---
id: api-transaction-get-txbodies-for-txblock-ex
title: GetTxnBodiesForTxBlockEx
---
---
This API behaves similar to [GetTxBodiesForTxBlock](api-transaction-get-txbodies-for-txblock.mdx) 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](api-blockchain-get-tx-block.mdx) or [GetLatestTxBlock](api-blockchain-get-latest-tx-block.mdx) 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
import Tabs from "@theme/Tabs";
import TabItem from "@theme/TabItem";
<Tabs
defaultValue="cURL"
values={[
{ label: 'cURL', value: 'cURL', },
]
}>
<TabItem value="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/"
```
</TabItem>
</Tabs>
### 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/ |
| **Developer testnet** | https://dev-api.zilliqa.com/ |
| **Local testnet** | http://localhost:4201/ |
| **Isolated server** | 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"` |