Blocks

Last updated 9 months ago

Submit a block.

Submit a block. The node takes care of missing* fields and tries to build the block. On success, the block will be stored in the Tangle. This endpoint will return the identifier of the built block. *The node will try to auto-fill the following fields in case they are missing: parents, nonce. If payload is missing, the block will be built without a payload. protocolVersion is always required!

post

/api/core/v2/blocks

Body

protocolVersionintegerrequired

Protocol version number of the block. It also tells which protocol rules apply to the block.

parentsstring[]

The identifiers of the blocks this block references. Hex-encoded with 0x prefix.

payloadone of

noncestring

The nonce which lets this block fulfill the Proof-of-Work requirement. Hex-encoded with 0x prefix.

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://iota.nownodes.io/api/core/v2/blocks' \
  --header 'Content-Type: application/json' \
  --data '{"protocolVersion":2,"parents":["0x222e88a63e5aca8ef48d3b8749e2fab51d1bc7c34c5604a2933ca2f180b342c9","0xa22137ebe61435c6d0f3e16ad148376778d7bfb36e27329f02c221ec109525a6","0xa6db9d0b3ecb274d90c21e9dde04012b2d13ad8aa0b90e82e7d3b626be67119d","0xfd31d9c926b5d97ae016535d66baee511dfa3b713b61d8eba2ae5c9929e38ca7"],"payload":{"type":5,"tag":"0x68656c6c6f20776f726c64","data":"0x5370616d6d696e6720646174612e0a436f756e743a203037323935320a54696d657374616d703a20323032312d30322d31315431303a32333a34392b30313a30300a54697073656c656374696f6e3a203934c2b573"},"nonce":"2102864"}'

201

400

403

500

503

{
  "blockId": "0xa4dd36465af63d495d35a05f592d42a51511c153e1bae8fad00453c8cbb48727"
}

Successful operation.

Returns block data as JSON by its identifier.

Find a block by its identifier. This endpoint returns the given block as JSON.

get

/api/core/v2/blocks/{blockId}

Path parameters

blockIdstringrequired

Identifier of the block.

Example: 0xf532a53545103276b46876c473846d98648ee418468bce76df4868648dd73e5d