Chia RPC (2.4.3)

Download OpenAPI specification:Download

Chia Network: hello@chia.net URL: https://www.chia.net/ License: Apache 2.0 Terms of Service

The Chia node and services come with a JSON RPC API server that allows you to access information and control the services. These are accessible via HTTPS, WebSockets, or via client SDKs. The ports can be configured in ~/.chia/mainnet/config/config.yaml. The RPC ports should not be exposed to the internet. TLS certificates are used to secure the communication using mutualTLS. The full node uses port 8555 by default.

Find out more about chia

Blocks

Methods for managing blocks.

Retrieves aggregate information about blocks.

Authorizations:

bearerAuth

Request Body schema: application/json
required

Empty request body

object

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

{"metrics": {"compact_blocks": 0,
"uncompact_blocks": 0,
"hint_count": 0
},
"success": true,
"error": "string"
}

Retrieves a block record by header hash.

Authorizations:

bearerAuth

Request Body schema: application/json
required

the block's header_hash

header_hash

required

string <hex>

Responses

Request samples

Payload

Content type

application/json

{"header_hash": "string"
}

Response samples

Content type

application/json

{"block_record": {"challenge_block_info_hash": "0x08dbc5c9f4676bad4cd2fad9b120afefdc107ffdd4066f73f14baf2a204f13df",
"challenge_vdf_output": {"data": "0x0000af33fa9862d4e257498e9ba0c3cda09c1389d1fde0facd72ea26f5371ba94deb18137d95bd83b1c7afefba6293feda91d744d014c747e132db0247839e9bd00d790c06f753a9d344c80c455a86ecd979c31687ece60748a5d62dca4723c3780d0906"
},
"deficit": 9,
"farmer_puzzle_hash": "0x8f5474dc460673a39c96bb0fdfea933f5d1269c138e47a67f07872c04803a4e7",
"fees": 0,
"finished_challenge_slot_hashes": null,
"finished_infused_challenge_slot_hashes": null,
"finished_reward_slot_hashes": null,
"header_hash": "0x3723909a7374c4c88cf00ab9b15365f4988f5bdb2d51bac23f6af939fe40f56c",
"height": 101,
"infused_challenge_vdf_output": "{\"data\":\"0x0300a4bc6790208e73245df6a85b3f7beac0d17e73972b414a7f94cf1e3c3e9bb4a400516d368cfa8b1814f3b5163fe5a54a1fe35781f58290673c8d9f56cd23b94c138b21207d6aa6f3049f8ad805eb99b28292e06e748117e78e13598cee9945670100\"}",
"overflow": false,
"pool_puzzle_hash": "0x8f5474dc460673a39c96bb0fdfea933f5d1269c138e47a67f07872c04803a4e7",
"prev_hash": "0x9a6c8728021574c5f3242370831b9fde7a0421f4448b4848276fe1652580c6a7",
"prev_transaction_block_hash": "0x6c94307cb88f37ca002936769246579824ecadc77fe1e445d31165e6958288e8",
"prev_transaction_block_height": 97,
"required_iters": 1045145,
"reward_claims_incorporated": "[{\"amount\":1750000000000,\"parent_coin_info\":\"0xccd5bb71183532bff220ba46c268991a00000000000000000000000000000061\",\"puzzle_hash\":\"0x8f3dff600992a0b77aefbe8eb81dd4f233b9126f3b67557594b5a927d6e6d588\"},{\"amount\":250000000000,\"parent_coin_info\":\"0x3ff07eb358e8255a65c30a2dce0e5fbb00000000000000000000000000000061\",\"puzzle_hash\":\"0x8f3dff600992a0b77aefbe8eb81dd4f233b9126f3b67557594b5a927d6e6d588\"}]",
"reward_infusion_new_challenge": "0x100b6fbe0778ae13e48e9bf71b7de4e31e5c1d73a0b041e0277f4a76b5338604",
"signage_point_index": 19,
"sub_epoch_summary_included": null,
"sub_slot_iters": 134217728,
"timestamp": 1616164827,
"total_iters": 449835673,
"weight": 714
},
"success": true,
"error": "string"
}

Retrieves block records in a range.

Retrieves block records in a range

Authorizations:

bearerAuth

Request Body schema: application/json
required

Start and end heights

start required	integer <uint32>
end required	integer <uint32>

Responses

Request samples

Payload

Content type

application/json

{"start": 0,
"end": 0
}

Response samples

Content type

application/json

{"block_records": [{"challenge_block_info_hash": "0x08dbc5c9f4676bad4cd2fad9b120afefdc107ffdd4066f73f14baf2a204f13df",
"challenge_vdf_output": {"data": "0x0000af33fa9862d4e257498e9ba0c3cda09c1389d1fde0facd72ea26f5371ba94deb18137d95bd83b1c7afefba6293feda91d744d014c747e132db0247839e9bd00d790c06f753a9d344c80c455a86ecd979c31687ece60748a5d62dca4723c3780d0906"
},
"deficit": 9,
"farmer_puzzle_hash": "0x8f5474dc460673a39c96bb0fdfea933f5d1269c138e47a67f07872c04803a4e7",
"fees": 0,
"finished_challenge_slot_hashes": null,
"finished_infused_challenge_slot_hashes": null,
"finished_reward_slot_hashes": null,
"header_hash": "0x3723909a7374c4c88cf00ab9b15365f4988f5bdb2d51bac23f6af939fe40f56c",
"height": 101,
"infused_challenge_vdf_output": "{\"data\":\"0x0300a4bc6790208e73245df6a85b3f7beac0d17e73972b414a7f94cf1e3c3e9bb4a400516d368cfa8b1814f3b5163fe5a54a1fe35781f58290673c8d9f56cd23b94c138b21207d6aa6f3049f8ad805eb99b28292e06e748117e78e13598cee9945670100\"}",
"overflow": false,
"pool_puzzle_hash": "0x8f5474dc460673a39c96bb0fdfea933f5d1269c138e47a67f07872c04803a4e7",
"prev_hash": "0x9a6c8728021574c5f3242370831b9fde7a0421f4448b4848276fe1652580c6a7",
"prev_transaction_block_hash": "0x6c94307cb88f37ca002936769246579824ecadc77fe1e445d31165e6958288e8",
"prev_transaction_block_height": 97,
"required_iters": 1045145,
"reward_claims_incorporated": "[{\"amount\":1750000000000,\"parent_coin_info\":\"0xccd5bb71183532bff220ba46c268991a00000000000000000000000000000061\",\"puzzle_hash\":\"0x8f3dff600992a0b77aefbe8eb81dd4f233b9126f3b67557594b5a927d6e6d588\"},{\"amount\":250000000000,\"parent_coin_info\":\"0x3ff07eb358e8255a65c30a2dce0e5fbb00000000000000000000000000000061\",\"puzzle_hash\":\"0x8f3dff600992a0b77aefbe8eb81dd4f233b9126f3b67557594b5a927d6e6d588\"}]",
"reward_infusion_new_challenge": "0x100b6fbe0778ae13e48e9bf71b7de4e31e5c1d73a0b041e0277f4a76b5338604",
"signage_point_index": 19,
"sub_epoch_summary_included": null,
"sub_slot_iters": 134217728,
"timestamp": 1616164827,
"total_iters": 449835673,
"weight": 714
}
],
"success": true,
"error": "string"
}

Retrieves a block record by height.

Retrieves a block record by height (assuming the height <= peak height). Note that not all blocks will have all fields set here (depending on transaction block, finishing sub epoch, etc).

Authorizations:

bearerAuth

Request Body schema: application/json
required

the block height

height

required

integer <uint32>

Responses

Request samples

Payload

Content type

application/json

{"height": 0
}

Response samples

Content type

application/json

{"block_record": {"challenge_block_info_hash": "0x08dbc5c9f4676bad4cd2fad9b120afefdc107ffdd4066f73f14baf2a204f13df",
"challenge_vdf_output": {"data": "0x0000af33fa9862d4e257498e9ba0c3cda09c1389d1fde0facd72ea26f5371ba94deb18137d95bd83b1c7afefba6293feda91d744d014c747e132db0247839e9bd00d790c06f753a9d344c80c455a86ecd979c31687ece60748a5d62dca4723c3780d0906"
},
"deficit": 9,
"farmer_puzzle_hash": "0x8f5474dc460673a39c96bb0fdfea933f5d1269c138e47a67f07872c04803a4e7",
"fees": 0,
"finished_challenge_slot_hashes": null,
"finished_infused_challenge_slot_hashes": null,
"finished_reward_slot_hashes": null,
"header_hash": "0x3723909a7374c4c88cf00ab9b15365f4988f5bdb2d51bac23f6af939fe40f56c",
"height": 101,
"infused_challenge_vdf_output": "{\"data\":\"0x0300a4bc6790208e73245df6a85b3f7beac0d17e73972b414a7f94cf1e3c3e9bb4a400516d368cfa8b1814f3b5163fe5a54a1fe35781f58290673c8d9f56cd23b94c138b21207d6aa6f3049f8ad805eb99b28292e06e748117e78e13598cee9945670100\"}",
"overflow": false,
"pool_puzzle_hash": "0x8f5474dc460673a39c96bb0fdfea933f5d1269c138e47a67f07872c04803a4e7",
"prev_hash": "0x9a6c8728021574c5f3242370831b9fde7a0421f4448b4848276fe1652580c6a7",
"prev_transaction_block_hash": "0x6c94307cb88f37ca002936769246579824ecadc77fe1e445d31165e6958288e8",
"prev_transaction_block_height": 97,
"required_iters": 1045145,
"reward_claims_incorporated": "[{\"amount\":1750000000000,\"parent_coin_info\":\"0xccd5bb71183532bff220ba46c268991a00000000000000000000000000000061\",\"puzzle_hash\":\"0x8f3dff600992a0b77aefbe8eb81dd4f233b9126f3b67557594b5a927d6e6d588\"},{\"amount\":250000000000,\"parent_coin_info\":\"0x3ff07eb358e8255a65c30a2dce0e5fbb00000000000000000000000000000061\",\"puzzle_hash\":\"0x8f3dff600992a0b77aefbe8eb81dd4f233b9126f3b67557594b5a927d6e6d588\"}]",
"reward_infusion_new_challenge": "0x100b6fbe0778ae13e48e9bf71b7de4e31e5c1d73a0b041e0277f4a76b5338604",
"signage_point_index": 19,
"sub_epoch_summary_included": null,
"sub_slot_iters": 134217728,
"timestamp": 1616164827,
"total_iters": 449835673,
"weight": 714
},
"success": true,
"error": "string"
}

Retrieves a block by header hash.

Authorizations:

bearerAuth

Request Body schema: application/json
required

the block's header_hash

header_hash

required

string <hex>

Responses

Request samples

Payload

Content type

application/json

{"header_hash": "string"
}

Response samples

Content type

application/json

{"block": {"finished_sub_slots": [ ],
"reward_chain_block": {"weight": 0,
"height": 0,
"total_iters": 4212156346430,
"signage_point_index": 37,
"pos_ss_cc_challenge_hash": "0x04b130f89a8fc37519eab0d835a43ef5547552b2b67c5129fa00f79a57ba8d7f",
"proof_of_space": {"challenge": "0xad43c12b5c5a480ee93992697bd8c9153d536007b0ffac024341cd8ca853a9e3",
"public_pool_key": "string",
"pool_contract_puzzle_hash": "0x71afdce401a0f2a6f03de6287902eacfa38502d6667b04da36e32c3930171ce4",
"plot_public_key": "0x8b5f3cd22bf5073e12f285d2a0e9bbfb485fea8f3ede2f5573e44168fadbb91b71cef1dffc03758a5241c47b105df81a",
"size": 25,
"proof": "0xa84606d3dba86cbc1c2f56d05175bbbcb970629380bec5c49ad46f0c5f067e4ba74101ac24f0e09fb73ce0ebc9249436c528b5fab689d94c4213072e2acfc1c3a6f17763b16304234002ce471da4ce7e888e2f5abadf4d7f48cd157294ce03cb28df0f45597ca5460cd66c772c7650f2d170d08a5898fe65623b33aac864f44d2a39bcf074e62866edccf9b424f9a8ca56c9a98e87d48fb02b933af951284d610ff1eb71e730a05c2f6c7be86fd4df7efb26e8fb2e573981d8ad866adc02a82ffb0d7ff106c9c78f9cea08f4a2de9db2607266edf6e807924edf9af0f36b8938d97865072126011b67646b4d0e206b706d3a3e67e8862cb0502520f1ad1b4341"
},
"challenge_chain_sp_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"challenge_chain_sp_signature": "0xa6058eaa6e9cf8469e152e80b4ac4c3cfdca8660cbe44ca50d3771ab1bbf1d040cba842d1b9bf633756159859ecb2ebc05b5f994cef91d5915d4763284e340095a59fb87f2e50fc3f0b6658d1663aeb9d6732373203d7e45df56eb19baeff64c",
"challenge_chain_ip_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"reward_chain_sp_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"reward_chain_sp_signature": "0xa4fb8eb7afc74b945efe1f6b28453a708df7de1f0b56239c5fed50974b896b9bb1f559b49b5a6cf7f4351f1545918b5017e28e81f974bc7bdba88b61f2f9ca8492ab9b7d23371e579b30da9a1a5c7dc0a8fe5605a86165d34c3c552f509fdd7b",
"reward_chain_ip_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"infused_challenge_chain_ip_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"is_transaction_block": true
},
"challenge_chain_sp_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"challenge_chain_ip_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"reward_chain_sp_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"reward_chain_ip_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"infused_challenge_chain_ip_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"foliage": {"prev_block_hash": "0x0b08b0ceca65b371729ad3731ba5982c0c63d487cd526874fb907c3e683eb185",
"reward_block_hash": "0xcc705bd601b6c9e3081bde85db2a917d312716136e077c37e7f5090c2685733f",
"foliage_block_data": {"unfinished_reward_block_hash": "0xcc705bd601b6c9e3081bde85db2a917d312716136e077c37e7f5090c2685733f",
"pool_target": {"puzzle_hash": "0x77c08f1ae7c6ae4808c8c07f7d99363b0c00f0ad416c4a292b5341282e38dc35",
"max_height": 0
},
"pool_signature": "0xb39237cb5db187f1a3f210f5fff1bee0f7b66e466eb1bd393204768d982335f3ee5c7faec138e334110d80ce47e46704067db26f8a2c5267bbaefb74ea9ef144bd51a8fe388ba68727f3e246b8aefef427b2e2e299ed976d27ba2789bcf7cb7c",
"farmer_reward_puzzle_hash": "0x77c08f1ae7c6ae4808c8c07f7d99363b0c00f0ad416c4a292b5341282e38dc35",
"extension_data": "0x0000000000000000000000000000000000000000000000000000000003a2c7c9"
},
"foliage_block_data_signature": "0x838f98f281429094df95adbd023f7ac285ffe08d7e584e0e1c9d6def26b215f86753f52d781116eab02ac949beea9b9c009b6242ba97568f226aeafc2bf4fc83b791fffb2d636a8b0473727b5bee6a560b09df3dabf9d2b4ca707a35f22e5f38",
"foliage_transaction_block_hash": "0x813540921a72fdfcbe47858e087b9e848df5fe2d8213288a6df71acf22214cf2",
"foliage_transaction_block_signature": "0xb0db31ae6d773b3b27009cfdd9a232b54f840e00caf24a5a87e8c27e96933acd03d8e553ea62e9179ed4078ed86b9e471987e8803ff4311c9d0727d876490012af403094e3baa4f627785d846c60f770494c253ea7a09e7bc24a53ad683e4704"
},
"foliage_transaction_block": {"prev_transaction_block_hash": "0xf88a87d79c8e65ca559b7e74a9aca3a6f9fc90e6bb9dc6cb4602ed599610876e",
"timestamp": 1636577488,
"filter_hash": "0xea0d50f296d1bdaccc00be16e48a310dd4fa1fcf575065761add6366498b3fbf",
"additions_root": "0x2c04ae163cf5916b774e2591b075560b6dface2b242d10cbb9f40b134cdf2080",
"removals_root": "0x409433654e3b7a530da6cf55c93abde2c7a71a2ea9814883ceef956f8fed61ea",
"transactions_info_hash": "0x9f3d9cb990c560fb66d4e09a9da79844ce933a809bc754eb151775f3600b73ed"
},
"transactions_info": {"generator_root": "string",
"generator_refs_root": "string",
"aggregated_signature": "string",
"fees": 0,
"cost": 0,
"reward_claims_incorporated": [{"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
}
]
},
"transactions_generator": null,
"transactions_generator_ref_list": [ ],
"header_hash": "string",
"is_transaction_block": true
},
"success": true,
"error": "string"
}

Retrieves the spends in the given block.

Authorizations:

bearerAuth

Request Body schema: application/json
required

the block's header_hash

header_hash

required

string <hex>

Responses

Request samples

Payload

Content type

application/json

{"header_hash": "string"
}

Response samples

Content type

application/json

{"block_spends": [{"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
}
],
"success": true,
"error": "string"
}

Get the blocks between a start and end height.

Get the blocks between a start and end height

Authorizations:

bearerAuth

Request Body schema: application/json
required

Start and end heights

start required	integer <uint32>
end required	integer <uint32>
exclude_header_hash	boolean Default: false
exclude_reorged	boolean Default: false

Responses

Request samples

Payload

Content type

application/json

{"start": 0,
"end": 0,
"exclude_header_hash": false,
"exclude_reorged": false
}

Response samples

Content type

application/json

{"blocks": [{"finished_sub_slots": [ ],
"reward_chain_block": {"weight": 0,
"height": 0,
"total_iters": 4212156346430,
"signage_point_index": 37,
"pos_ss_cc_challenge_hash": "0x04b130f89a8fc37519eab0d835a43ef5547552b2b67c5129fa00f79a57ba8d7f",
"proof_of_space": {"challenge": "0xad43c12b5c5a480ee93992697bd8c9153d536007b0ffac024341cd8ca853a9e3",
"public_pool_key": "string",
"pool_contract_puzzle_hash": "0x71afdce401a0f2a6f03de6287902eacfa38502d6667b04da36e32c3930171ce4",
"plot_public_key": "0x8b5f3cd22bf5073e12f285d2a0e9bbfb485fea8f3ede2f5573e44168fadbb91b71cef1dffc03758a5241c47b105df81a",
"size": 25,
"proof": "0xa84606d3dba86cbc1c2f56d05175bbbcb970629380bec5c49ad46f0c5f067e4ba74101ac24f0e09fb73ce0ebc9249436c528b5fab689d94c4213072e2acfc1c3a6f17763b16304234002ce471da4ce7e888e2f5abadf4d7f48cd157294ce03cb28df0f45597ca5460cd66c772c7650f2d170d08a5898fe65623b33aac864f44d2a39bcf074e62866edccf9b424f9a8ca56c9a98e87d48fb02b933af951284d610ff1eb71e730a05c2f6c7be86fd4df7efb26e8fb2e573981d8ad866adc02a82ffb0d7ff106c9c78f9cea08f4a2de9db2607266edf6e807924edf9af0f36b8938d97865072126011b67646b4d0e206b706d3a3e67e8862cb0502520f1ad1b4341"
},
"challenge_chain_sp_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"challenge_chain_sp_signature": "0xa6058eaa6e9cf8469e152e80b4ac4c3cfdca8660cbe44ca50d3771ab1bbf1d040cba842d1b9bf633756159859ecb2ebc05b5f994cef91d5915d4763284e340095a59fb87f2e50fc3f0b6658d1663aeb9d6732373203d7e45df56eb19baeff64c",
"challenge_chain_ip_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"reward_chain_sp_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"reward_chain_sp_signature": "0xa4fb8eb7afc74b945efe1f6b28453a708df7de1f0b56239c5fed50974b896b9bb1f559b49b5a6cf7f4351f1545918b5017e28e81f974bc7bdba88b61f2f9ca8492ab9b7d23371e579b30da9a1a5c7dc0a8fe5605a86165d34c3c552f509fdd7b",
"reward_chain_ip_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"infused_challenge_chain_ip_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"is_transaction_block": true
},
"challenge_chain_sp_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"challenge_chain_ip_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"reward_chain_sp_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"reward_chain_ip_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"infused_challenge_chain_ip_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"foliage": {"prev_block_hash": "0x0b08b0ceca65b371729ad3731ba5982c0c63d487cd526874fb907c3e683eb185",
"reward_block_hash": "0xcc705bd601b6c9e3081bde85db2a917d312716136e077c37e7f5090c2685733f",
"foliage_block_data": {"unfinished_reward_block_hash": "0xcc705bd601b6c9e3081bde85db2a917d312716136e077c37e7f5090c2685733f",
"pool_target": {"puzzle_hash": "0x77c08f1ae7c6ae4808c8c07f7d99363b0c00f0ad416c4a292b5341282e38dc35",
"max_height": 0
},
"pool_signature": "0xb39237cb5db187f1a3f210f5fff1bee0f7b66e466eb1bd393204768d982335f3ee5c7faec138e334110d80ce47e46704067db26f8a2c5267bbaefb74ea9ef144bd51a8fe388ba68727f3e246b8aefef427b2e2e299ed976d27ba2789bcf7cb7c",
"farmer_reward_puzzle_hash": "0x77c08f1ae7c6ae4808c8c07f7d99363b0c00f0ad416c4a292b5341282e38dc35",
"extension_data": "0x0000000000000000000000000000000000000000000000000000000003a2c7c9"
},
"foliage_block_data_signature": "0x838f98f281429094df95adbd023f7ac285ffe08d7e584e0e1c9d6def26b215f86753f52d781116eab02ac949beea9b9c009b6242ba97568f226aeafc2bf4fc83b791fffb2d636a8b0473727b5bee6a560b09df3dabf9d2b4ca707a35f22e5f38",
"foliage_transaction_block_hash": "0x813540921a72fdfcbe47858e087b9e848df5fe2d8213288a6df71acf22214cf2",
"foliage_transaction_block_signature": "0xb0db31ae6d773b3b27009cfdd9a232b54f840e00caf24a5a87e8c27e96933acd03d8e553ea62e9179ed4078ed86b9e471987e8803ff4311c9d0727d876490012af403094e3baa4f627785d846c60f770494c253ea7a09e7bc24a53ad683e4704"
},
"foliage_transaction_block": {"prev_transaction_block_hash": "0xf88a87d79c8e65ca559b7e74a9aca3a6f9fc90e6bb9dc6cb4602ed599610876e",
"timestamp": 1636577488,
"filter_hash": "0xea0d50f296d1bdaccc00be16e48a310dd4fa1fcf575065761add6366498b3fbf",
"additions_root": "0x2c04ae163cf5916b774e2591b075560b6dface2b242d10cbb9f40b134cdf2080",
"removals_root": "0x409433654e3b7a530da6cf55c93abde2c7a71a2ea9814883ceef956f8fed61ea",
"transactions_info_hash": "0x9f3d9cb990c560fb66d4e09a9da79844ce933a809bc754eb151775f3600b73ed"
},
"transactions_info": {"generator_root": "string",
"generator_refs_root": "string",
"aggregated_signature": "string",
"fees": 0,
"cost": 0,
"reward_claims_incorporated": [{"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
}
]
},
"transactions_generator": null,
"transactions_generator_ref_list": [ ],
"header_hash": "string",
"is_transaction_block": true
}
],
"success": true,
"error": "string"
}

Retrieves unfinished block headers.

Authorizations:

bearerAuth

Request Body schema: application/json
required

Empty request body

object

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

{"headers": [{"finished_sub_slots": [{"challenge_chain": {"challenge_chain_end_of_slot_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"infused_challenge_chain_sub_slot_hash": null,
"subepoch_summary_hash": null,
"new_sub_slot_iters": null,
"new_difficulty": null
},
"infused_challenge_chain": {"infused_challenge_chain_end_of_slot_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
}
},
"reward_chain": {"end_of_slot_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"challenge_chain_sub_slot_hash": "0xe44e06ed13eb06c7c2f0218945b7c62e785d6482c27ebbe69aab499ae199258c",
"infused_challenge_chain_sub_slot_hash": null,
"deficit": 12
},
"proofs": {"challenge_chain_slot_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"infused_challenge_chain_slot_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"reward_chain_slot_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
}
}
}
],
"reward_chain_block": {"total_iters": 4212156346430,
"signage_point_index": 37,
"pos_ss_cc_challenge_hash": "0x04b130f89a8fc37519eab0d835a43ef5547552b2b67c5129fa00f79a57ba8d7f",
"proof_of_space": {"challenge": "0xad43c12b5c5a480ee93992697bd8c9153d536007b0ffac024341cd8ca853a9e3",
"public_pool_key": "string",
"pool_contract_puzzle_hash": "0x71afdce401a0f2a6f03de6287902eacfa38502d6667b04da36e32c3930171ce4",
"plot_public_key": "0x8b5f3cd22bf5073e12f285d2a0e9bbfb485fea8f3ede2f5573e44168fadbb91b71cef1dffc03758a5241c47b105df81a",
"size": 25,
"proof": "0xa84606d3dba86cbc1c2f56d05175bbbcb970629380bec5c49ad46f0c5f067e4ba74101ac24f0e09fb73ce0ebc9249436c528b5fab689d94c4213072e2acfc1c3a6f17763b16304234002ce471da4ce7e888e2f5abadf4d7f48cd157294ce03cb28df0f45597ca5460cd66c772c7650f2d170d08a5898fe65623b33aac864f44d2a39bcf074e62866edccf9b424f9a8ca56c9a98e87d48fb02b933af951284d610ff1eb71e730a05c2f6c7be86fd4df7efb26e8fb2e573981d8ad866adc02a82ffb0d7ff106c9c78f9cea08f4a2de9db2607266edf6e807924edf9af0f36b8938d97865072126011b67646b4d0e206b706d3a3e67e8862cb0502520f1ad1b4341"
},
"challenge_chain_sp_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"challenge_chain_sp_signature": "0xa6058eaa6e9cf8469e152e80b4ac4c3cfdca8660cbe44ca50d3771ab1bbf1d040cba842d1b9bf633756159859ecb2ebc05b5f994cef91d5915d4763284e340095a59fb87f2e50fc3f0b6658d1663aeb9d6732373203d7e45df56eb19baeff64c",
"reward_chain_sp_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"reward_chain_sp_signature": "0xa4fb8eb7afc74b945efe1f6b28453a708df7de1f0b56239c5fed50974b896b9bb1f559b49b5a6cf7f4351f1545918b5017e28e81f974bc7bdba88b61f2f9ca8492ab9b7d23371e579b30da9a1a5c7dc0a8fe5605a86165d34c3c552f509fdd7b"
},
"challenge_chain_sp_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"reward_chain_sp_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"foliage": {"prev_block_hash": "0x0b08b0ceca65b371729ad3731ba5982c0c63d487cd526874fb907c3e683eb185",
"reward_block_hash": "0xcc705bd601b6c9e3081bde85db2a917d312716136e077c37e7f5090c2685733f",
"foliage_block_data": {"unfinished_reward_block_hash": "0xcc705bd601b6c9e3081bde85db2a917d312716136e077c37e7f5090c2685733f",
"pool_target": {"puzzle_hash": "0x77c08f1ae7c6ae4808c8c07f7d99363b0c00f0ad416c4a292b5341282e38dc35",
"max_height": 0
},
"pool_signature": "0xb39237cb5db187f1a3f210f5fff1bee0f7b66e466eb1bd393204768d982335f3ee5c7faec138e334110d80ce47e46704067db26f8a2c5267bbaefb74ea9ef144bd51a8fe388ba68727f3e246b8aefef427b2e2e299ed976d27ba2789bcf7cb7c",
"farmer_reward_puzzle_hash": "0x77c08f1ae7c6ae4808c8c07f7d99363b0c00f0ad416c4a292b5341282e38dc35",
"extension_data": "0x0000000000000000000000000000000000000000000000000000000003a2c7c9"
},
"foliage_block_data_signature": "0x838f98f281429094df95adbd023f7ac285ffe08d7e584e0e1c9d6def26b215f86753f52d781116eab02ac949beea9b9c009b6242ba97568f226aeafc2bf4fc83b791fffb2d636a8b0473727b5bee6a560b09df3dabf9d2b4ca707a35f22e5f38",
"foliage_transaction_block_hash": "0x813540921a72fdfcbe47858e087b9e848df5fe2d8213288a6df71acf22214cf2",
"foliage_transaction_block_signature": "0xb0db31ae6d773b3b27009cfdd9a232b54f840e00caf24a5a87e8c27e96933acd03d8e553ea62e9179ed4078ed86b9e471987e8803ff4311c9d0727d876490012af403094e3baa4f627785d846c60f770494c253ea7a09e7bc24a53ad683e4704"
},
"foliage_transaction_block": {"prev_transaction_block_hash": "0xf88a87d79c8e65ca559b7e74a9aca3a6f9fc90e6bb9dc6cb4602ed599610876e",
"timestamp": 1636577488,
"filter_hash": "0xea0d50f296d1bdaccc00be16e48a310dd4fa1fcf575065761add6366498b3fbf",
"additions_root": "0x2c04ae163cf5916b774e2591b075560b6dface2b242d10cbb9f40b134cdf2080",
"removals_root": "0x409433654e3b7a530da6cf55c93abde2c7a71a2ea9814883ceef956f8fed61ea",
"transactions_info_hash": "0x9f3d9cb990c560fb66d4e09a9da79844ce933a809bc754eb151775f3600b73ed"
},
"transactions_filter": "string"
}
],
"success": true,
"error": "string"
}

Retrieves the additions and removals for a certain block.

Retrieves the additions and removals (state transitions) for a certain block. Returns coin records for each addition and removal.

Authorizations:

bearerAuth

Request Body schema: application/json
required

the block's header_hash

header_hash

required

string <hex>

Responses

Request samples

Payload

Content type

application/json

{"header_hash": "string"
}

Response samples

Content type

application/json

{"additions": [{"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"confirmed_block_index": 922637,
"spent_block_index": 922641,
"spent": true,
"coinbase": false,
"timestamp": 1632832094
}
],
"removals": [{"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"confirmed_block_index": 922637,
"spent_block_index": 922641,
"spent": true,
"coinbase": false,
"timestamp": 1632832094
}
],
"success": true,
"error": "string"
}

Retrieves a recent signage point or end of slot.

Authorizations:

bearerAuth

Request Body schema: application/json
required

The signage point hash or challenge hash. If both are present sp_hash takes precedence.

One of

sp_hash

string <hex>

Responses

Request samples

Payload

Content type

application/json

{"challenge_hash": "string"
}

Response samples

Content type

application/json

{"eos": {"challenge_chain": {"challenge_chain_end_of_slot_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"infused_challenge_chain_sub_slot_hash": null,
"subepoch_summary_hash": null,
"new_sub_slot_iters": null,
"new_difficulty": null
},
"infused_challenge_chain": {"infused_challenge_chain_end_of_slot_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
}
},
"reward_chain": {"end_of_slot_vdf": {"challenge": "0xeb8c4d20b322be8d9fddbf9412016bdffe9a2901d7edb0e364e94266d0e095f7",
"number_of_iterations": 1024,
"output": {"data": "string"
}
},
"challenge_chain_sub_slot_hash": "0xe44e06ed13eb06c7c2f0218945b7c62e785d6482c27ebbe69aab499ae199258c",
"infused_challenge_chain_sub_slot_hash": null,
"deficit": 12
},
"proofs": {"challenge_chain_slot_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"infused_challenge_chain_slot_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
},
"reward_chain_slot_proof": {"witness_type": 0,
"witness": "0x02004c00010100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"normalized_to_identity": false
}
}
},
"time_received": 0.1,
"reverted": true,
"success": true,
"error": "string"
}

Retrieves the spends in the given block, including its conditions.

Authorizations:

bearerAuth

Request Body schema: application/json
required

the block's header_hash

header_hash

required

string <hex>

Responses

Request samples

Payload

Content type

application/json

{"header_hash": "string"
}

Response samples

Content type

application/json

{"block_spends_with_conditions": [{"coin_spend": {"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
},
"conditions": [{"opcode": 0,
"vars": ["string"
]
}
]
}
],
"success": true,
"error": "string"
}

Coins

Methods for managing coins.

Retrieves the coins for a given puzzlehash.

Retrieves the coins for a given puzzlehash, by default returns unspent coins.

Authorizations:

bearerAuth

Request Body schema: application/json
required

The puzzle hash.

puzzle_hash required	string <hex>
start_height	integer <uint32>
end_height	integer <uint32>
include_spent_coins	boolean

Responses

Request samples

Payload

Content type

application/json

{"puzzle_hash": "string",
"start_height": 0,
"end_height": 0,
"include_spent_coins": true
}

Response samples

Content type

application/json

{"coin_records": [{"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"confirmed_block_index": 922637,
"spent_block_index": 922641,
"spent": true,
"coinbase": false,
"timestamp": 1632832094
}
],
"success": true,
"error": "string"
}

Retrieves the coins for a given puzzlehashes

Retrieves the coins for a given puzzlehashes, by default returns unspent coins.

Authorizations:

bearerAuth

Request Body schema: application/json
required

The puzzle hashes.

puzzle_hashes required	Array of strings <hex> [ items <hex > ]
start_height	integer <uint32>
end_height	integer <uint32>
include_spent_coins	boolean

Responses

Request samples

Payload

Content type

application/json

{"puzzle_hashes": ["string"
],
"start_height": 0,
"end_height": 0,
"include_spent_coins": true
}

Response samples

Content type

application/json

{"coin_records": [{"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"confirmed_block_index": 922637,
"spent_block_index": 922641,
"spent": true,
"coinbase": false,
"timestamp": 1632832094
}
],
"success": true,
"error": "string"
}

Retrieves coins by hint.

Retrieves coins by hint, by default returns unspent coins.

Authorizations:

bearerAuth

Request Body schema: application/json
required

The hint.

hint required	string <hex>
start_height	integer <uint32>
end_height	integer <uint32>
include_spent_coins	boolean

Responses

Request samples

Payload

Content type

application/json

{"hint": "string",
"start_height": 0,
"end_height": 0,
"include_spent_coins": true
}

Response samples

Content type

application/json

{"coin_records": [{"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"confirmed_block_index": 922637,
"spent_block_index": 922641,
"spent": true,
"coinbase": false,
"timestamp": 1632832094
}
],
"success": true,
"error": "string"
}

Retrieves a coin record by it's name.

Authorizations:

bearerAuth

Request Body schema: application/json
required

The coin name.

name

required

string <hex>

Responses

Request samples

Payload

Content type

application/json

{"name": "string"
}

Response samples

Content type

application/json

{"coin_record": {"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"confirmed_block_index": 922637,
"spent_block_index": 922641,
"spent": true,
"coinbase": false,
"timestamp": 1632832094
},
"success": true,
"error": "string"
}

Retrieves the coins for given coin IDs.

Retrieves the coins for given coin IDs, by default returns unspent coins.

Authorizations:

bearerAuth

Request Body schema: application/json
required

The coin names.

names required	Array of strings <hex> [ items <hex > ]
start_height	integer <uint32>
end_height	integer <uint32>
include_spent_coins	boolean

Responses

Request samples

Payload

Content type

application/json

{"names": ["string"
],
"start_height": 0,
"end_height": 0,
"include_spent_coins": true
}

Response samples

Content type

application/json

{"coin_records": [{"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"confirmed_block_index": 922637,
"spent_block_index": 922641,
"spent": true,
"coinbase": false,
"timestamp": 1632832094
}
],
"success": true,
"error": "string"
}

Retrieves the coins for given parent coin IDs.

Retrieves the coins for given parent coin IDs, by default returns unspent coins.

Authorizations:

bearerAuth

Request Body schema: application/json
required

The parent ids.

parent_ids required	Array of strings <hex> [ items <hex > ]
start_height	integer <uint32>
end_height	integer <uint32>
include_spent_coins	boolean

Responses

Request samples

Payload

Content type

application/json

{"parent_ids": ["string"
],
"start_height": 0,
"end_height": 0,
"include_spent_coins": true
}

Response samples

Content type

application/json

{"coin_records": [{"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"confirmed_block_index": 922637,
"spent_block_index": 922641,
"spent": true,
"coinbase": false,
"timestamp": 1632832094
}
],
"success": true,
"error": "string"
}

Retrieves a coin solution.

Authorizations:

bearerAuth

Request Body schema: application/json
required

The coin id and height

coin_id required	string <hex>
height required	integer <uint32>

Responses

Request samples

Payload

Content type

application/json

{"coin_id": "string",
"height": 0
}

Response samples

Content type

application/json

{"coin_solution": {"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
},
"success": true,
"error": "string"
}

Pushes a transaction/spend bundle to the mempool and blockchain.

Pushes a transaction/spend bundle to the mempool and blockchain. Returns whether the spend bundle was successfully included into the mempool.

Authorizations:

bearerAuth

Request Body schema: application/json
required

The spend bundle

required

object (spend_bundle)

Responses

Request samples

Payload

Content type

application/json

{"spend_bundle": {"aggregated_signature": "0xa5e5ea1f5ae2335a72fe0a7ed7ca39e8f142e2e1f6e37a348482290e88eb9cea2d973acf6145e34d0afeee7ba22f99850641e21a549b2c092bb49aa393acd938825bccca9413c1a268ba44367bc8433cd0fc0eb82e87bebe23817aa695bdb566",
"coin_spends": [{"coin": {"amount": 1750000000000,
"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10"
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
}
]
}
}

Response samples

Content type

application/json

{"status": "string",
"success": true,
"error": "string"
}

Shared

Methods shared by all services.

Stop the node.

Authorizations:

bearerAuth

Request Body schema: application/json
required

Empty request body

object

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

{"success": true,
"error": "string"
}

Add a connection to another node.

Authorizations:

bearerAuth

Request Body schema: application/json
required

the address of the connection

ip required	string <ipaddress>
port required	integer

Responses

Request samples

Payload

Content type

application/json

{"ip": "string",
"port": 0
}

Response samples

Content type

application/json

{"success": true,
"error": "string"
}

Removes a connection.

Authorizations:

bearerAuth

Request Body schema: application/json
required

the node id of the connection

node_id

required

string

Responses

Request samples

Payload

Content type

application/json

{"node_id": "string"
}

Response samples

Content type

application/json

{"success": true,
"error": "string"
}

Retrieve the list of connections.

Authorizations:

bearerAuth

Request Body schema: application/json
required

Empty request body

object

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

{"connections": [{"bytes_read": 0,
"bytes_written": 0,
"creation_time": 0.1,
"last_message_time": 0.1,
"local_port": 0,
"node_id": "string",
"peak_hash": "string",
"peak_height": 0,
"peak_weight": 0,
"peer_host": "string",
"peer_port": 0,
"peer_server_port": 0,
"type": 1
}
],
"success": true,
"error": "string"
}

Heartbeat.

Authorizations:

bearerAuth

Request Body schema: application/json
required

Empty request body

object

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

{"success": true,
"error": "string"
}

Retrieve the list of routes exposed by the service.

Retrieve the list of routes/endpoints exposed by the service.

Authorizations:

bearerAuth

Request Body schema: application/json
required

Empty request body

object

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

{"routes": ["string"
],
"success": true,
"error": "string"
}

Retrieves some information about the current network.

Authorizations:

bearerAuth

Request Body schema: application/json
required

Empty request body

object

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

{"network_name": "mainnet",
"network_prefix": "xch",
"genesis_challenge": "f4c0c9d5b3cd59d6f7c76ecd780e646a2c55064367d0ddbb42b2b6462a4674b2",
"success": true,
"error": "string"
}

Get the installed version of chia at the endpoint.

Authorizations:

bearerAuth

Request Body schema: application/json
required

Empty request body

object

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

{"version": "string",
"success": true,
"error": "string"
}

Full Node

The full node RPC API is exposed, by default, on port 8555. This port must not be exposed publicly for security concerns.

Retrieves a summary of the current state of the blockchain and full node.

Authorizations:

bearerAuth

Request Body schema: application/json
required

Empty request body

object

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

{"blockchain_state": {"node_id": "string",
"difficulty": 3008,
"genesis_challenge_initialized": true,
"mempool_size": 0,
"mempool_cost": 0,
"mempool_fees": 0,
"mempool_min_fees": {"cost_5000000": 0.1
},
"mempool_max_total_cost": 0,
"block_max_cost": 0,
"peak": {"challenge_block_info_hash": "0x08dbc5c9f4676bad4cd2fad9b120afefdc107ffdd4066f73f14baf2a204f13df",
"challenge_vdf_output": {"data": "0x0000af33fa9862d4e257498e9ba0c3cda09c1389d1fde0facd72ea26f5371ba94deb18137d95bd83b1c7afefba6293feda91d744d014c747e132db0247839e9bd00d790c06f753a9d344c80c455a86ecd979c31687ece60748a5d62dca4723c3780d0906"
},
"deficit": 9,
"farmer_puzzle_hash": "0x8f5474dc460673a39c96bb0fdfea933f5d1269c138e47a67f07872c04803a4e7",
"fees": 0,
"finished_challenge_slot_hashes": null,
"finished_infused_challenge_slot_hashes": null,
"finished_reward_slot_hashes": null,
"header_hash": "0x3723909a7374c4c88cf00ab9b15365f4988f5bdb2d51bac23f6af939fe40f56c",
"height": 101,
"infused_challenge_vdf_output": "{\"data\":\"0x0300a4bc6790208e73245df6a85b3f7beac0d17e73972b414a7f94cf1e3c3e9bb4a400516d368cfa8b1814f3b5163fe5a54a1fe35781f58290673c8d9f56cd23b94c138b21207d6aa6f3049f8ad805eb99b28292e06e748117e78e13598cee9945670100\"}",
"overflow": false,
"pool_puzzle_hash": "0x8f5474dc460673a39c96bb0fdfea933f5d1269c138e47a67f07872c04803a4e7",
"prev_hash": "0x9a6c8728021574c5f3242370831b9fde7a0421f4448b4848276fe1652580c6a7",
"prev_transaction_block_hash": "0x6c94307cb88f37ca002936769246579824ecadc77fe1e445d31165e6958288e8",
"prev_transaction_block_height": 97,
"required_iters": 1045145,
"reward_claims_incorporated": "[{\"amount\":1750000000000,\"parent_coin_info\":\"0xccd5bb71183532bff220ba46c268991a00000000000000000000000000000061\",\"puzzle_hash\":\"0x8f3dff600992a0b77aefbe8eb81dd4f233b9126f3b67557594b5a927d6e6d588\"},{\"amount\":250000000000,\"parent_coin_info\":\"0x3ff07eb358e8255a65c30a2dce0e5fbb00000000000000000000000000000061\",\"puzzle_hash\":\"0x8f3dff600992a0b77aefbe8eb81dd4f233b9126f3b67557594b5a927d6e6d588\"}]",
"reward_infusion_new_challenge": "0x100b6fbe0778ae13e48e9bf71b7de4e31e5c1d73a0b041e0277f4a76b5338604",
"signage_point_index": 19,
"sub_epoch_summary_included": null,
"sub_slot_iters": 134217728,
"timestamp": 1616164827,
"total_iters": 449835673,
"weight": 714
},
"space": 40110198681182960000,
"sub_slot_iters": 136314880,
"average_block_time": 2,
"sync": {"sync_mode": false,
"sync_progress_height": 0,
"sync_tip_height": 0,
"synced": false
}
},
"success": true,
"error": "string"
}

Retrieves an estimate of total space.

Retrieves an estimate of total space validating the chain between two block header hashes.

Authorizations:

bearerAuth

Request Body schema: application/json
required

The block header hashes

newer_block_header_hash required	string <hex>
older_block_header_hash required	string <hex>

Responses

Request samples

Payload

Content type

application/json

{"newer_block_header_hash": "string",
"older_block_header_hash": "string"
}

Response samples

Content type

application/json

{"space": 0,
"success": true,
"error": "string"
}

Retrieves aggregated signature additional data.

Authorizations:

bearerAuth

Request Body schema: application/json
required

Empty request body

object

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

{"additional_data": "string",
"success": true,
"error": "string"
}

Mempool

Get information about the mempool.

Returns a list of all transaction IDs in the mempool.

Returns a list of all transaction IDs (spend bundle hashes) in the mempool.

Authorizations:

bearerAuth

Request Body schema: application/json
required

Empty request body

object

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

{"tx_ids": ["string"
],
"success": true,
"error": "string"
}

Returns all items in the mempool.

Authorizations:

bearerAuth

Request Body schema: application/json
required

Empty request body

object

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

{"mempool_items": {"property1": {"spend_bundle": {"aggregated_signature": "0xa5e5ea1f5ae2335a72fe0a7ed7ca39e8f142e2e1f6e37a348482290e88eb9cea2d973acf6145e34d0afeee7ba22f99850641e21a549b2c092bb49aa393acd938825bccca9413c1a268ba44367bc8433cd0fc0eb82e87bebe23817aa695bdb566",
"coin_spends": [{"coin": {"amount": 1750000000000,
"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10"
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
}
]
},
"fee": 0,
"npc_result": {"error": null,
"conds": {"spends": [{"coin_id": "string",
"puzzle_hash": "string",
"height_relative": 0,
"before_seconds_relative": 0,
"birth_height": 0,
"birth_seconds": 0,
"create_coin": ["string",
0,
"string"
],
"agg_sig_me": ["string",
"string"
],
"flags": 0
}
],
"reserve_fee": 0,
"height_absolute": 0,
"seconds_absolute": 0,
"before_height_absolute": 0,
"before_seconds_absolute": 0,
"agg_sig_unsafe": ["string",
"string"
],
"cost": 0,
"removal_amount": 0,
"addition_amount": 0
}
},
"cost": 10940866,
"spend_bundle_name": "string",
"additions": [{"amount": 3968760041,
"parent_coin_info": "0xbf71e1d17630e3793321944b5825b5b573ac28c03113498baae997e0781f0278",
"puzzle_hash": "0x3be9de8637a998987687d6e3f1df95b6bcde6a2cbc7ed96b40fbc9d76bb5033d"
}
],
"removals": [{"amount": 3981342052,
"parent_coin_info": "0x0252418f0ad7a0009dc055a48a2aaff897f4ea6289b57f1ed9c0d8c7a5b5e6a8",
"puzzle_hash": "0xdd259fada9e1fbfb1499df0755462222f31ec512404842b5c7dac26b9a5cb29a"
}
],
"assert_height": null,
"assert_before_height": null,
"assert_before_seconds": null,
"bundle_coin_spends": {"property1": {"coin_spend": {"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
},
"eligible_for_dedup": true,
"eligible_for_fast_forward": true,
"additions": [{"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
}
],
"cost": null
},
"property2": {"coin_spend": {"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
},
"eligible_for_dedup": true,
"eligible_for_fast_forward": true,
"additions": [{"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
}
],
"cost": null
}
}
},
"property2": {"spend_bundle": {"aggregated_signature": "0xa5e5ea1f5ae2335a72fe0a7ed7ca39e8f142e2e1f6e37a348482290e88eb9cea2d973acf6145e34d0afeee7ba22f99850641e21a549b2c092bb49aa393acd938825bccca9413c1a268ba44367bc8433cd0fc0eb82e87bebe23817aa695bdb566",
"coin_spends": [{"coin": {"amount": 1750000000000,
"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10"
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
}
]
},
"fee": 0,
"npc_result": {"error": null,
"conds": {"spends": [{"coin_id": "string",
"puzzle_hash": "string",
"height_relative": 0,
"before_seconds_relative": 0,
"birth_height": 0,
"birth_seconds": 0,
"create_coin": ["string",
0,
"string"
],
"agg_sig_me": ["string",
"string"
],
"flags": 0
}
],
"reserve_fee": 0,
"height_absolute": 0,
"seconds_absolute": 0,
"before_height_absolute": 0,
"before_seconds_absolute": 0,
"agg_sig_unsafe": ["string",
"string"
],
"cost": 0,
"removal_amount": 0,
"addition_amount": 0
}
},
"cost": 10940866,
"spend_bundle_name": "string",
"additions": [{"amount": 3968760041,
"parent_coin_info": "0xbf71e1d17630e3793321944b5825b5b573ac28c03113498baae997e0781f0278",
"puzzle_hash": "0x3be9de8637a998987687d6e3f1df95b6bcde6a2cbc7ed96b40fbc9d76bb5033d"
}
],
"removals": [{"amount": 3981342052,
"parent_coin_info": "0x0252418f0ad7a0009dc055a48a2aaff897f4ea6289b57f1ed9c0d8c7a5b5e6a8",
"puzzle_hash": "0xdd259fada9e1fbfb1499df0755462222f31ec512404842b5c7dac26b9a5cb29a"
}
],
"assert_height": null,
"assert_before_height": null,
"assert_before_seconds": null,
"bundle_coin_spends": {"property1": {"coin_spend": {"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
},
"eligible_for_dedup": true,
"eligible_for_fast_forward": true,
"additions": [{"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
}
],
"cost": null
},
"property2": {"coin_spend": {"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
},
"eligible_for_dedup": true,
"eligible_for_fast_forward": true,
"additions": [{"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
}
],
"cost": null
}
}
}
},
"success": true,
"error": "string"
}

Returns a specific item from the mempool.

Authorizations:

bearerAuth

Request Body schema: application/json
required

The tx id.

tx_id required	string <hex>
include_pending	boolean Default: false

Responses

Request samples

Payload

Content type

application/json

{"tx_id": "string",
"include_pending": false
}

Response samples

Content type

application/json

{"mempool_item": {"spend_bundle": {"aggregated_signature": "0xa5e5ea1f5ae2335a72fe0a7ed7ca39e8f142e2e1f6e37a348482290e88eb9cea2d973acf6145e34d0afeee7ba22f99850641e21a549b2c092bb49aa393acd938825bccca9413c1a268ba44367bc8433cd0fc0eb82e87bebe23817aa695bdb566",
"coin_spends": [{"coin": {"amount": 1750000000000,
"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10"
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
}
]
},
"fee": 0,
"npc_result": {"error": null,
"conds": {"spends": [{"coin_id": "string",
"puzzle_hash": "string",
"height_relative": 0,
"before_seconds_relative": 0,
"birth_height": 0,
"birth_seconds": 0,
"create_coin": ["string",
0,
"string"
],
"agg_sig_me": ["string",
"string"
],
"flags": 0
}
],
"reserve_fee": 0,
"height_absolute": 0,
"seconds_absolute": 0,
"before_height_absolute": 0,
"before_seconds_absolute": 0,
"agg_sig_unsafe": ["string",
"string"
],
"cost": 0,
"removal_amount": 0,
"addition_amount": 0
}
},
"cost": 10940866,
"spend_bundle_name": "string",
"additions": [{"amount": 3968760041,
"parent_coin_info": "0xbf71e1d17630e3793321944b5825b5b573ac28c03113498baae997e0781f0278",
"puzzle_hash": "0x3be9de8637a998987687d6e3f1df95b6bcde6a2cbc7ed96b40fbc9d76bb5033d"
}
],
"removals": [{"amount": 3981342052,
"parent_coin_info": "0x0252418f0ad7a0009dc055a48a2aaff897f4ea6289b57f1ed9c0d8c7a5b5e6a8",
"puzzle_hash": "0xdd259fada9e1fbfb1499df0755462222f31ec512404842b5c7dac26b9a5cb29a"
}
],
"assert_height": null,
"assert_before_height": null,
"assert_before_seconds": null,
"bundle_coin_spends": {"property1": {"coin_spend": {"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
},
"eligible_for_dedup": true,
"eligible_for_fast_forward": true,
"additions": [{"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
}
],
"cost": null
},
"property2": {"coin_spend": {"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
},
"eligible_for_dedup": true,
"eligible_for_fast_forward": true,
"additions": [{"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
}
],
"cost": null
}
}
},
"success": true,
"error": "string"
}

Gets items in the mempool by a coin name.

Authorizations:

bearerAuth

Request Body schema: application/json
required

coin_name

required

string <hex>

Responses

Request samples

Payload

Content type

application/json

{"coin_name": "string"
}

Response samples

Content type

application/json

{"mempool_items": [{"spend_bundle": {"aggregated_signature": "0xa5e5ea1f5ae2335a72fe0a7ed7ca39e8f142e2e1f6e37a348482290e88eb9cea2d973acf6145e34d0afeee7ba22f99850641e21a549b2c092bb49aa393acd938825bccca9413c1a268ba44367bc8433cd0fc0eb82e87bebe23817aa695bdb566",
"coin_spends": [{"coin": {"amount": 1750000000000,
"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10"
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
}
]
},
"fee": 0,
"npc_result": {"error": null,
"conds": {"spends": [{"coin_id": "string",
"puzzle_hash": "string",
"height_relative": 0,
"before_seconds_relative": 0,
"birth_height": 0,
"birth_seconds": 0,
"create_coin": ["string",
0,
"string"
],
"agg_sig_me": ["string",
"string"
],
"flags": 0
}
],
"reserve_fee": 0,
"height_absolute": 0,
"seconds_absolute": 0,
"before_height_absolute": 0,
"before_seconds_absolute": 0,
"agg_sig_unsafe": ["string",
"string"
],
"cost": 0,
"removal_amount": 0,
"addition_amount": 0
}
},
"cost": 10940866,
"spend_bundle_name": "string",
"additions": [{"amount": 3968760041,
"parent_coin_info": "0xbf71e1d17630e3793321944b5825b5b573ac28c03113498baae997e0781f0278",
"puzzle_hash": "0x3be9de8637a998987687d6e3f1df95b6bcde6a2cbc7ed96b40fbc9d76bb5033d"
}
],
"removals": [{"amount": 3981342052,
"parent_coin_info": "0x0252418f0ad7a0009dc055a48a2aaff897f4ea6289b57f1ed9c0d8c7a5b5e6a8",
"puzzle_hash": "0xdd259fada9e1fbfb1499df0755462222f31ec512404842b5c7dac26b9a5cb29a"
}
],
"assert_height": null,
"assert_before_height": null,
"assert_before_seconds": null,
"bundle_coin_spends": {"property1": {"coin_spend": {"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
},
"eligible_for_dedup": true,
"eligible_for_fast_forward": true,
"additions": [{"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
}
],
"cost": null
},
"property2": {"coin_spend": {"coin": {"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
},
"puzzle_reveal": "0xff02ffff01ff02ffff01ff02ffff03ff0bffff01ff02ffff03ffff09ff05ffff1dff0bffff1effff0bff0bffff02ff06ffff04ff02ffff04ff17ff8080808080808080ffff01ff02ff17ff2f80ffff01ff088080ff0180ffff01ff04ffff04ff04ffff04ff05ffff04ffff02ff06ffff04ff02ffff04ff17ff80808080ff80808080ffff02ff17ff2f808080ff0180ffff04ffff01ff32ff02ffff03ffff07ff0580ffff01ff0bffff0102ffff02ff06ffff04ff02ffff04ff09ff80808080ffff02ff06ffff04ff02ffff04ff0dff8080808080ffff01ff0bffff0101ff058080ff0180ff018080ffff04ffff01b0aec9c2e5984fe928406abca942d55ec6b56340af8315bfefa55889dbaade669b9fd3f330af2af44c2a0626d383e64757ff018080",
"solution": "0xff80ffff01ffff33ffa03fa549a708302b401c45cf387f8f03b4f76b7c9eabf567bea974f61dedf721e0ff840098968080ffff33ffa055b9fe4c9ce0cef8ad574bf5a9158dc0db7848b96be1a98ab2806d8f0a376a08ff860197738845808080ff8080"
},
"eligible_for_dedup": true,
"eligible_for_fast_forward": true,
"additions": [{"parent_coin_info": "0xccd5bb71183532bff220ba46c268991a00000000000000000000000000004082",
"puzzle_hash": "0x94c6db00186900418ef7c1f05e127ee1a647cbe6e514ec3bc57acb7bbe6dfb10",
"amount": 1750000000000
}
],
"cost": null
}
}
}
],
"success": true,
"error": "string"
}

Fees

Get information about fees.

Estimates the fee for a given spend_bundle.

Authorizations:

bearerAuth

Request Body schema: application/json
required

The spend bundle

One of

required	object (spend_bundle)
target_times required	Array of integers
spend_count	integer Default: 1

Responses

Request samples

Payload

Content type

application/json

{"spend_type": "send_xch_transaction",
"target_times": [0
],
"spend_count": 1
}

Response samples

Content type

application/json

{"estimates": [0
],
"target_times": [0
],
"current_fee_rate": 0,
"mempool_size": 0,
"mempool_fees": 0,
"mempool_max_size": 0,
"num_spends": 0,
"full_node_synced": true,
"peak_height": 0,
"last_peak_timestamp": 0,
"last_block_cost": 0,
"fees_last_block": 0,
"fee_rate_last_block": 0,
"last_tx_block_height": 0,
"node_time_utc": 0,
"success": true,
"error": "string"
}

Chia RPC (2.4.3)

Blocks

Retrieves aggregate information about blocks.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Retrieves a block record by header hash.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Retrieves block records in a range.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Retrieves a block record by height.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Retrieves a block by header hash.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Retrieves the spends in the given block.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get the blocks between a start and end height.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Retrieves unfinished block headers.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Retrieves the additions and removals for a certain block.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Retrieves a recent signage point or end of slot.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Retrieves the spends in the given block, including its conditions.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Coins

Retrieves the coins for a given puzzlehash.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Retrieves the coins for a given puzzlehashes

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required