Block

Block Api

Deprecated

Get latest block (v1)

get

https://rpc-testnet.supra.comhttps://rpc-wallet-testnet.supra.comhttps://rpc-suprascan-testnet.supra.comhttps://rpc-archive-testnet.supra.comhttps://rpc-suprascan-reprocessing-testnet.supra.comhttps://rpc-testnet1.supra.comhttp://localhost:27000

/rpc/v1/block

Get the header of the most recently finalized block.

Responses

200

Returns the header of the most recently finalized block.

application/json

nullOptional

or

get

/rpc/v1/block

HTTPcURLJavaScriptPython

GET /rpc/v1/block HTTP/1.1
Host: rpc-testnet.supra.com
Accept: */*

200

Returns the header of the most recently finalized block.

No content

Deprecated

Get block by height (v1)

get

https://rpc-testnet.supra.comhttps://rpc-wallet-testnet.supra.comhttps://rpc-suprascan-testnet.supra.comhttps://rpc-archive-testnet.supra.comhttps://rpc-suprascan-reprocessing-testnet.supra.comhttps://rpc-testnet1.supra.comhttp://localhost:27000

/rpc/v1/block/height/{height}

Get information about the block that has been finalized at the given height.

Path parameters

heightinteger · u-int64Required

Block height

Query parameters

with_finalized_transactionsbooleanRequired

If true, returns all transactions that were finalized by this block in the order that they were executed.

Responses

200

Information about the block that has been finalized at the given height.

application/json

nullOptional

or

404

Requested data is not available.

application/json

410

Requested data has been pruned and is no longer available.

application/json

get

/rpc/v1/block/height/{height}

HTTPcURLJavaScriptPython

GET /rpc/v1/block/height/{height}?with_finalized_transactions=true HTTP/1.1
Host: rpc-testnet.supra.com
Accept: */*

No content

Deprecated

Get block by hash (v1)

get

https://rpc-testnet.supra.comhttps://rpc-wallet-testnet.supra.comhttps://rpc-suprascan-testnet.supra.comhttps://rpc-archive-testnet.supra.comhttps://rpc-suprascan-reprocessing-testnet.supra.comhttps://rpc-testnet1.supra.comhttp://localhost:27000

/rpc/v1/block/{block_hash}

Get the header of the block with the given hash.

Path parameters

block_hashstringRequired

Hash of block to retrieve

Responses

200

The header of the block with the given hash.

application/json

nullOptional

or

get

/rpc/v1/block/{block_hash}

HTTPcURLJavaScriptPython

GET /rpc/v1/block/{block_hash} HTTP/1.1
Host: rpc-testnet.supra.com
Accept: */*

200

The header of the block with the given hash.

No content

Get transactions by block hash (v1)

get

https://rpc-testnet.supra.comhttps://rpc-wallet-testnet.supra.comhttps://rpc-suprascan-testnet.supra.comhttps://rpc-archive-testnet.supra.comhttps://rpc-suprascan-reprocessing-testnet.supra.comhttps://rpc-testnet1.supra.comhttp://localhost:27000

/rpc/v1/block/{block_hash}/transactions

Get a list containing the hashes of the transactions that were finalized in the block with the given hash in the order that they were executed.

Path parameters

block_hashstringRequired

Hex encoded block hash

Responses

200

List of the hashes of the transactions contained in the block.

application/json

string[]Optional

Hex encoded hash

get

/rpc/v1/block/{block_hash}/transactions

HTTPcURLJavaScriptPython

GET /rpc/v1/block/{block_hash}/transactions HTTP/1.1
Host: rpc-testnet.supra.com
Accept: */*

200

List of the hashes of the transactions contained in the block.

[
  "text"
]

Get latest block (v2)

get

https://rpc-testnet.supra.comhttps://rpc-wallet-testnet.supra.comhttps://rpc-suprascan-testnet.supra.comhttps://rpc-archive-testnet.supra.comhttps://rpc-suprascan-reprocessing-testnet.supra.comhttps://rpc-testnet1.supra.comhttp://localhost:27000

/rpc/v2/block

Get the header of the most recently finalized block.

Responses

200

Returns the header of the most recently finalized block.

application/json

Metadata about a Supra block.

authorstringRequired

Hex encoded identity.

hashstringRequired

Hex encoded hash

heightone ofRequired

Number of blocks before this block in the chain (including the genesis block).

integer · u-int64Optional

parentstringRequired

Hex encoded hash

get

/rpc/v2/block

HTTPcURLJavaScriptPython

GET /rpc/v2/block HTTP/1.1
Host: rpc-testnet.supra.com
Accept: */*

200

Returns the header of the most recently finalized block.

{
  "author": "text",
  "hash": "text",
  "height": 1,
  "parent": "text",
  "timestamp": {
    "timestamp": 1
  },
  "view": {
    "epoch_id": {
      "chain_id": 1,
      "epoch": 1
    },
    "round": 1
  }
}

Get block by height (v2)

get

https://rpc-testnet.supra.comhttps://rpc-wallet-testnet.supra.comhttps://rpc-suprascan-testnet.supra.comhttps://rpc-archive-testnet.supra.comhttps://rpc-suprascan-reprocessing-testnet.supra.comhttps://rpc-testnet1.supra.comhttp://localhost:27000

/rpc/v2/block/height/{height}

Get information about the block that has been finalized at the given height.

Path parameters

heightinteger · u-int64Required

Block height

Query parameters

with_finalized_transactionsbooleanRequired

If true, returns all transactions that were finalized by this block in the order that they were executed.

Responses

200

Information about the block that has been finalized at the given height.

application/json

The API representation of a Supra block.

404

Requested data is not available.

application/json

410

Requested data has been pruned and is no longer available.

application/json

get

/rpc/v2/block/height/{height}

HTTPcURLJavaScriptPython

GET /rpc/v2/block/height/{height}?with_finalized_transactions=true HTTP/1.1
Host: rpc-testnet.supra.com
Accept: */*

{
  "header": {
    "author": "text",
    "hash": "text",
    "height": 1,
    "parent": "text",
    "timestamp": {
      "timestamp": 1
    },
    "view": {
      "epoch_id": {
        "chain_id": 1,
        "epoch": 1
      },
      "round": 1
    }
  },
  "transactions": [
    {
      "authenticator": {},
      "block_header": null,
      "hash": "text",
      "header": {
        "chain_id": 1,
        "expiration_timestamp": {
          "timestamp": 1
        },
        "sender": "text",
        "sequence_number": 1,
        "gas_unit_price": 1,
        "max_gas_amount": 1
      },
      "payload": {},
      "output": {
        "Dkg": "Success"
      },
      "status": "Success"
    }
  ]
}

Get block by hash (v2)

get

https://rpc-testnet.supra.comhttps://rpc-wallet-testnet.supra.comhttps://rpc-suprascan-testnet.supra.comhttps://rpc-archive-testnet.supra.comhttps://rpc-suprascan-reprocessing-testnet.supra.comhttps://rpc-testnet1.supra.comhttp://localhost:27000

/rpc/v2/block/{block_hash}

Get the header of the block with the given hash.

Path parameters

block_hashstringRequired

Hex encoded block hash

Responses

200

The header of the block with the given hash.

application/json

Metadata about a Supra block.

authorstringRequired

Hex encoded identity.

hashstringRequired

Hex encoded hash

heightone ofRequired

Number of blocks before this block in the chain (including the genesis block).

integer · u-int64Optional

parentstringRequired

Hex encoded hash

get

/rpc/v2/block/{block_hash}

HTTPcURLJavaScriptPython

GET /rpc/v2/block/{block_hash} HTTP/1.1
Host: rpc-testnet.supra.com
Accept: */*

200

The header of the block with the given hash.

{
  "author": "text",
  "hash": "text",
  "height": 1,
  "parent": "text",
  "timestamp": {
    "timestamp": 1
  },
  "view": {
    "epoch_id": {
      "chain_id": 1,
      "epoch": 1
    },
    "round": 1
  }
}

Get latest block (v3)

get

https://rpc-testnet.supra.comhttps://rpc-wallet-testnet.supra.comhttps://rpc-suprascan-testnet.supra.comhttps://rpc-archive-testnet.supra.comhttps://rpc-suprascan-reprocessing-testnet.supra.comhttps://rpc-testnet1.supra.comhttp://localhost:27000

/rpc/v3/block

Get the meta information of the most recently finalized and executed block.

Responses

200

Returns the header of the most recently finalized block.

application/json

get

/rpc/v3/block

HTTPcURLJavaScriptPython

GET /rpc/v3/block HTTP/1.1
Host: rpc-testnet.supra.com
Accept: */*

200

Returns the header of the most recently finalized block.

{
  "header": {
    "author": "text",
    "hash": "text",
    "height": 1,
    "parent": "text",
    "timestamp": {
      "timestamp": 1
    },
    "view": {
      "epoch_id": {
        "chain_id": 1,
        "epoch": 1
      },
      "round": 1
    }
  },
  "execution_statistics": {
    "automated_txn_count": null,
    "automated_txn_gas_unit_price": null,
    "block_gas_unit_price_min": null,
    "block_gas_unit_price_max": null,
    "block_total_user_gas_used": null,
    "block_total_automated_gas_used": null,
    "user_txn_count": null
  }
}

Get block by height (v3)

get

https://rpc-testnet.supra.comhttps://rpc-wallet-testnet.supra.comhttps://rpc-suprascan-testnet.supra.comhttps://rpc-archive-testnet.supra.comhttps://rpc-suprascan-reprocessing-testnet.supra.comhttps://rpc-testnet1.supra.comhttp://localhost:27000

/rpc/v3/block/height/{height}

Get information about the block that has been finalized at the given height.

Path parameters

heightinteger · u-int64Required

Block height

Query parameters

with_finalized_transactionsbooleanOptional

If true, returns all transactions that were finalized by this block in the order that they were executed.

typestring · enumOptional

Type of the transaction to be queried.

Possible values:

Responses

200

Information about the block that has been finalized at the given height.

application/json

404

Requested data is not available.

application/json

410

Requested data has been pruned and is no longer available.

application/json

get

/rpc/v3/block/height/{height}

HTTPcURLJavaScriptPython

GET /rpc/v3/block/height/{height} HTTP/1.1
Host: rpc-testnet.supra.com
Accept: */*

{
  "header": {
    "author": "text",
    "hash": "text",
    "height": 1,
    "parent": "text",
    "timestamp": {
      "timestamp": 1
    },
    "view": {
      "epoch_id": {
        "chain_id": 1,
        "epoch": 1
      },
      "round": 1
    }
  },
  "execution_statistics": {
    "automated_txn_count": null,
    "automated_txn_gas_unit_price": null,
    "block_gas_unit_price_min": null,
    "block_gas_unit_price_max": null,
    "block_total_user_gas_used": null,
    "block_total_automated_gas_used": null,
    "user_txn_count": null
  },
  "transactions": [
    {
      "authenticator": {},
      "block_header": null,
      "hash": "text",
      "header": {
        "chain_id": 1,
        "expiration_timestamp": {
          "timestamp": 1
        },
        "sender": "text",
        "sequence_number": 1,
        "gas_unit_price": 1,
        "max_gas_amount": 1
      },
      "payload": {},
      "output": {
        "Dkg": "Success"
      },
      "status": "Success",
      "txn_type": "user"
    }
  ]
}

Get block by hash (v3)

get

https://rpc-testnet.supra.comhttps://rpc-wallet-testnet.supra.comhttps://rpc-suprascan-testnet.supra.comhttps://rpc-archive-testnet.supra.comhttps://rpc-suprascan-reprocessing-testnet.supra.comhttps://rpc-testnet1.supra.comhttp://localhost:27000

/rpc/v3/block/{block_hash}

Get the header and execution output statistics of the block with the given hash.

Path parameters

block_hashstringRequired

Hex encoded block hash

Responses

200

The header of the block with the given hash.

application/json

get

/rpc/v3/block/{block_hash}

HTTPcURLJavaScriptPython

GET /rpc/v3/block/{block_hash} HTTP/1.1
Host: rpc-testnet.supra.com
Accept: */*

200

The header of the block with the given hash.

{
  "header": {
    "author": "text",
    "hash": "text",
    "height": 1,
    "parent": "text",
    "timestamp": {
      "timestamp": 1
    },
    "view": {
      "epoch_id": {
        "chain_id": 1,
        "epoch": 1
      },
      "round": 1
    }
  },
  "execution_statistics": {
    "automated_txn_count": null,
    "automated_txn_gas_unit_price": null,
    "block_gas_unit_price_min": null,
    "block_gas_unit_price_max": null,
    "block_total_user_gas_used": null,
    "block_total_automated_gas_used": null,
    "user_txn_count": null
  }
}

Get transactions by block hash (v3)

get

https://rpc-testnet.supra.comhttps://rpc-wallet-testnet.supra.comhttps://rpc-suprascan-testnet.supra.comhttps://rpc-archive-testnet.supra.comhttps://rpc-suprascan-reprocessing-testnet.supra.comhttps://rpc-testnet1.supra.comhttp://localhost:27000

/rpc/v3/block/{block_hash}/transactions

Get a list containing the hashes of the transactions that were finalized in the block with the given hash in the order that they were executed.

Path parameters

block_hashstringRequired

Hex encoded block hash

Query parameters

typestring · enumOptional

Type of the transaction to be queried.

Possible values:

Responses

200

List of the hashes of the transactions contained in the block.

application/json

Responsestring[]

Hex encoded hash

get

/rpc/v3/block/{block_hash}/transactions

HTTPcURLJavaScriptPython

GET /rpc/v3/block/{block_hash}/transactions HTTP/1.1
Host: rpc-testnet.supra.com
Accept: */*

200

List of the hashes of the transactions contained in the block.

[
  "text"
]