QueryService

QueryService defines unary RPCs for accessing blockchain data.

Package: thru.services.v1

RPCs

GetHeight

Get block heights

• Request: GetHeightRequest
• Response: GetHeightResponse

Try it live thru.services.v1.QueryService/GetHeight

Request JSON {}

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetChainInfo

Get chain-level information including chain ID.

• Request: GetChainInfoRequest
• Response: GetChainInfoResponse

Try it live thru.services.v1.QueryService/GetChainInfo

Request JSON {}

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetAccount

Get account information.

• Request: GetAccountRequest
• Response: thru.core.v1.Account

Try it live thru.services.v1.QueryService/GetAccount

Request JSON { "address": { "value": "tz1X8LkZq4SVPGH0Jrb9B8yeOPKfTOMJ/rSbs70D5XU=" } }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetRawAccount

Get account raw bytes.

• Request: GetRawAccountRequest
• Response: thru.core.v1.RawAccount

Try it live thru.services.v1.QueryService/GetRawAccount

Request JSON { "address": { "value": "tz1X8LkZq4SVPGH0Jrb9B8yeOPKfTOMJ/rSbs70D5XU=" } }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetTransaction

Get transaction by signature.

• Request: GetTransactionRequest
• Response: thru.core.v1.Transaction

Try it live thru.services.v1.QueryService/GetTransaction

Request JSON { "signature": { "value": "2Jqjbuct1yuDSIsJJlol3NG1MvvBtsiETcSXopHFOPC7QaD0DnqBbUceMnCxd8ItFrQFOK1iLXDFl0w2GYZlDw==" } }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetRawTransaction

Get raw transaction by signature.

• Request: GetRawTransactionRequest
• Response: thru.core.v1.RawTransaction

Try it live thru.services.v1.QueryService/GetRawTransaction

Request JSON { "signature": { "value": "2Jqjbuct1yuDSIsJJlol3NG1MvvBtsiETcSXopHFOPC7QaD0DnqBbUceMnCxd8ItFrQFOK1iLXDFl0w2GYZlDw==" } }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetBlock

Get block by slot or hash.

• Request: GetBlockRequest
• Response: thru.core.v1.Block

Try it live thru.services.v1.QueryService/GetBlock

Request JSON { "slot": "80200" }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetRawBlock

Get raw block bytes.

• Request: GetRawBlockRequest
• Response: thru.core.v1.RawBlock

Try it live thru.services.v1.QueryService/GetRawBlock

Request JSON { "slot": "80200" }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

ListAccounts

List accounts using CEL-based filtering.

• Request: ListAccountsRequest
• Response: ListAccountsResponse

Try it live thru.services.v1.QueryService/ListAccounts

Request JSON { "filter": { "expression": "account.meta.balance > uint(0)" }, "page": { "pageSize": 5 } }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

ListBlocks

List blocks using pagination and filtering. By default returns blocks ordered from latest slot to the first one.

• Request: ListBlocksRequest
• Response: ListBlocksResponse

Try it live thru.services.v1.QueryService/ListBlocks

Request JSON { "page": { "pageSize": 5 } }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

ListTransactionsForAccount

List executed transaction signatures involving an account.

• Request: ListTransactionsForAccountRequest
• Response: ListTransactionsForAccountResponse

Try it live thru.services.v1.QueryService/ListTransactionsForAccount

Request JSON { "account": { "value": "tz1X8LkZq4SVPGH0Jrb9B8yeOPKfTOMJ/rSbs70D5XU=" }, "page": { "pageSize": 5 } }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetEvent

Get a specific event by ID.

• Request: GetEventRequest
• Response: Event

Try it live thru.services.v1.QueryService/GetEvent

Request JSON { "eventId": "tse_4tl2wZSKaw5boRQe_JaZuEyNvXKbC5FAOxeUaG3VT3Bo0n1jQQn30TuZMphjB3NDN7jkUaFDSMcAzvNE99CByN:80255:4:0" }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

ListEvents

List events with CEL filtering and pagination. Returns events ordered from most recent to older.

• Request: ListEventsRequest
• Response: ListEventsResponse

Try it live thru.services.v1.QueryService/ListEvents

Request JSON { "page": { "pageSize": 5 } }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

ListTransactions

List executed transactions with CEL filtering and pagination. Returns transactions ordered from most recent to older.

• Request: ListTransactionsRequest
• Response: ListTransactionsResponse

Try it live thru.services.v1.QueryService/ListTransactions

Request JSON { "page": { "pageSize": 5 } }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetTransactionStatus

Get derived transaction status metadata.

• Request: GetTransactionStatusRequest
• Response: TransactionStatus

Try it live thru.services.v1.QueryService/GetTransactionStatus

Request JSON { "signature": { "value": "2Jqjbuct1yuDSIsJJlol3NG1MvvBtsiETcSXopHFOPC7QaD0DnqBbUceMnCxd8ItFrQFOK1iLXDFl0w2GYZlDw==" } }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GenerateStateProof

Generate an account state proof snapshot.

• Request: GenerateStateProofRequest
• Response: GenerateStateProofResponse

Try it live thru.services.v1.QueryService/GenerateStateProof

Request JSON { "request": { "address": { "value": "tz1X8LkZq4SVPGH0Jrb9B8yeOPKfTOMJ/rSbs70D5XU=" }, "targetSlot": "80200" } }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetVersion

Get component version strings.

• Request: GetVersionRequest
• Response: GetVersionResponse

Try it live thru.services.v1.QueryService/GetVersion

Request JSON {}

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetStateRoots

Get state roots for a range of slots. Used for transaction replay to verify state proofs against historical roots.

• Request: GetStateRootsRequest
• Response: GetStateRootsResponse

Try it live thru.services.v1.QueryService/GetStateRoots

Request JSON { "slot": "80200" }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetActiveStateHashes

Get active state hashes for a range of slots.

• Request: GetActiveStateHashesRequest
• Response: GetActiveStateHashesResponse

Try it live thru.services.v1.QueryService/GetActiveStateHashes

Request JSON { "endSlot": "80200", "startSlot": "80190" }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetSlotMetrics

Get slot-level metrics including state counters and collected fees.

• Request: GetSlotMetricsRequest
• Response: GetSlotMetricsResponse

Try it live thru.services.v1.QueryService/GetSlotMetrics

Request JSON { "slot": "80200" }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

ListSlotMetrics

List slot metrics for a range of slots.

• Request: ListSlotMetricsRequest
• Response: ListSlotMetricsResponse

Try it live thru.services.v1.QueryService/ListSlotMetrics

Request JSON { "startSlot": "80190", "endSlot": "80200" }

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetNodePubkey

Get the node’s own ED25519 public key.

• Request: GetNodePubkeyRequest
• Response: GetNodePubkeyResponse

Try it live thru.services.v1.QueryService/GetNodePubkey

Request JSON {}

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetNodeRecords

Get all known node records from the gossip network.

• Request: GetNodeRecordsRequest
• Response: GetNodeRecordsResponse

Try it live thru.services.v1.QueryService/GetNodeRecords

Request JSON {}

Send POST https://grpc-web.alphanet.thruput.org

Response

—

GetNodeStatus

Get the node’s operational status including consensus readiness.

• Request: GetNodeStatusRequest
• Response: GetNodeStatusResponse

Try it live thru.services.v1.QueryService/GetNodeStatus

Request JSON {}

Send POST https://grpc-web.alphanet.thruput.org

Response

—