combinepsbtcombinerawtransactionconverttopsbtcreatepsbtcreaterawtransactiondecodepsbtdecoderawtransactiondecodescriptfinalizepsbtfundrawtransactiongetbestblockhashgetblockgetblockchaininfogetblockcountgetblockhashgetblockheadergetblockstatsgetblocktemplategetchaintipsgetchaintxstatsgetdifficultygetfinalizedblockhashgetmemoryinfogetmempoolancestorsgetmempooldescendantsgetmempoolentrygetmempoolinfogetmininginfogetnetworkhashpsgetrawmempoolgetrawtransactiongetrpcinfogettxoutgettxoutproofhelppreciousblocksendrawtransactionsignrawtransactionwithkeytestmempoolacceptuptimevalidateaddressverifymessagecheck_sendproofget_block_headerget_random_outputsget_raw_blockget_raw_transactionget_statisticsget_statussend_transactionsync_blockssync_mem_pool
abortrescanaddmultisigaddressaddnodeclearbannedcreatemultisigcreatewalletdisconnectnodedumpprivkeydumpwalletencryptwalletestimatefeefinalizeblockgenerategeneratetoaddressgetaddednodeinfogetaddressesbylabelgetaddressinfogetbalancegetbalancesgetblocktemplatelightgetconnectioncountgetdsproofgetdsprooflistgetexcessiveblockgetnettotalsgetnetworkinfogetnewaddressgetnodeaddressesgetpeerinfogetrawchangeaddressgetreceivedbyaddressgettxoutsetinfogetunconfirmedbalancegetwalletinfoimportaddressimportmultiimportprivkeyimportprunedfundsimportpubkeyimportwalletinvalidateblockkeypoolrefilllistaddressgroupingslistbannedlistlabelslistlockunspentlistsinceblocklisttransactionslistunspentlistwalletdirlistwalletsloadwalletlockunspentloggingparkblockpingprioritisetransactionpruneblockchainreconsiderblockremoveprunedfundsrescanblockchainsavemempoolscantxoutsetsendmanysendtoaddresssetbansetexcessiveblocksethdseedsetlabelsetnetworkactivesettxfeesetwalletflagsignmessagesignmessagewithprivkeysignrawtransactionwithwalletstopsubmitblocksubmitblocklightsubmitheaderunloadwalletunparkblockverifychainverifytxoutproofwalletcreatefundedpsbtwalletprocesspsbtget_block_templateget_currency_idsubmit_block
Last updated on January 1, 1970
89 min read
Method sync_blocks Bitcoin Cash (BCH)
connect with JSON-RPC protocol
sync_blocks
Fetches blocks from local blockchain. In order to perform a request asparse chain (a specific sequence of local blocks) has to be assembledand sent. Returns missing blocks, start_height and regular get_statusresponse.
Parameters
sparse_chain - array of string
A specific sequence of local block hashes.
Sparse_chain is a sequence of blocks hashes from the last known block to genesis block. It goes backward into blockchain like this: last ten blocks, then block in 2 blocks, block in 4 blocks, block in 8 blocks, ..., genesis block.
first_block_timestamp - timestamp
Optional.
bytecoind won't return blocks earlier than this point in time.
max_count - uint32
Optional.
Maximum number of blocks to return.
Request
curl --location --request POST 'https://bcn.getblock.io/mainnet/'
--header 'x-api-key: YOUR-API-KEY'
--header 'Content-Type: application/json'
--data-raw '{"jsonrpc": "2.0",
"method": "sync_blocks",
"params": {"sparse_chain": ["856c8547ad1864cc08664df8b41ebdd6ab8a01dd7ba04cbc06a428d64cd7e844"], "max_count": 2},
"id": "getblock.io"}'
Response
{
"id": "getblock.io",
"jsonrpc": "2.0",
"result": {
"blocks": [
{
"header": {
"already_generated_coins": 18444651493828161509,
"already_generated_key_outputs": 63482012,
"already_generated_transactions": 6659692,
"base_reward": 7982589202,
"binary_nonce": "28c76209",
"block_capacity_vote": 100000,
"block_capacity_vote_median": 100000,
"block_size": 5707,
"cumulative_difficulty": 30627729797502340,
"difficulty": 11933350361,
"effective_size_median": 0,
"hash": "0012daca5694fd5f228e61144160a0f2c2b9920e467012930b3a67393c607988",
"height": 2398925,
"major_version": 4,
"minor_version": 7,
"nonce": 157468456,
"previous_block_hash": "856c8547ad1864cc08664df8b41ebdd6ab8a01dd7ba04cbc06a428d64cd7e844",
"reward": 7983279202,
"size_median": 0,
"timestamp": 1631266587,
"timestamp_median": 1631263229,
"transactions_fee": 690000,
"transactions_size": 5092
},
"output_stack_indexes": [
[
1472,
964,
791404,
801323,
1424618,
854652
],
[
1652,
1204465,
774975
]
],
"raw_header": {
"coinbase_transaction": {
"extra": "01db4b1131bc6fb9c96e7f84291aff6947663887e5ea1042a3d11fac9592b2839a0403a08d06",
"inputs": [
{
"height": 2398925,
"type": "coinbase"
}
],
"outputs": [
{
"amount": 279000,
"public_key": "09e5e9735184180875736ccf29f61b579b34accb79a86bd87a4135412122cf3c",
"type": "key"
},
{
"amount": 202,
"public_key": "57c2ff72ebbcf3e7a423ac9cc7febeee766e1c7e4870758ee431269d3cab5867",
"type": "key"
},
{
"amount": 3000000,
"public_key": "bfd0091cd7ce95536891b83aca07483d41cdad0a5aa18bae39676daac544f1ed",
"type": "key"
},
{
"amount": 80000000,
"public_key": "7c3d28c0b151bb812f9d198cb938d492887c9a2b5dbee18da36b46ab422d5681",
"type": "key"
},
{
"amount": 900000000,
"public_key": "af8c54a3d39abca4f09cf7556fc2d5b6ad5183e60abcdf58a6db1516c86b95a2",
"type": "key"
},
{
"amount": 7000000000,
"public_key": "8e8450f60036c828f83d8a2f70800e2029a7e982b4564c608e94f7e184ac59db",
"type": "key"
}
],
"unlock_block_or_timestamp": 0,
"version": 1
},
"major_version": 4,
"minor_version": 7,
"previous_block_hash": "856c8547ad1864cc08664df8b41ebdd6ab8a01dd7ba04cbc06a428d64cd7e844",
"root_block": {
"blockchain_branch": [],
"coinbase_transaction": {
"extra": "019d5eeb8985fc4821ef9cf1dd0ede73cf1b2839ec446b13778185eb59bcf4a458021100000000338641b2176d8855ad000000000321006034fa13f2d74a9daed316da63fd2707f96a72f02e659e233e91e383d4d5b610",
"inputs": [
{
"height": 660469,
"type": "coinbase"
}
],
"outputs": [
{
"amount": 2,
"public_key": "b60ecae662a57ee4f5cc2c14db0535c290013da05dbc24fc4988ecdef9b33478",
"type": "key"
},
{
"amount": 20,
"public_key": "5430c49adbf7ffa75788ba20acf126e11104b05c4cc22eb6bf9b9ac792c25c62",
"type": "key"
},
{
"amount": 600,
"public_key": "88924931480957967a1a5c611705e6e53cdfabf013e6d9c6d4ea871f708851e5",
"type": "key"
},
{
"amount": 3000,
"public_key": "cffe33d4fdb85e2d4da16624134190acbc1c9f4cc7044d589300d0e128c2e340",
"type": "key"
},
{
"amount": 50000,
"public_key": "31014cf71887788c50fa2037f332a299f4b92bf26b67c6643e751d23fadcd5b5",
"type": "key"
},
{
"amount": 800000,
"public_key": "6355505712ef1140a317c158af0b9a3eb174761ba7d37c7e57f74a664ddf3d01",
"type": "key"
},
{
"amount": 9000000,
"public_key": "76ad02f95e2ac21dfa351a0429c688dbec740a046fa891a64aef2d6d90b05d1e",
"type": "key"
},
{
"amount": 60000000,
"public_key": "b7d0b37e0114ade840023ad754e6e01791eb948710dc4da6245b575aa0cef15a",
"type": "key"
},
{
"amount": 700000000,
"public_key": "9f01a58c670ffd991ddc36d3d00c0d3ddf63a3fdc34b5cbb8beecc013b655035",
"type": "key"
},
{
"amount": 1000000000,
"public_key": "ff0efdb3c4d5c717f8824de62e5d3e562eb81ec84fb15f4a6d32c75b6f4f85ef",
"type": "key"
},
{
"amount": 70000000000,
"public_key": "b40d1a2bc28b450dc67e7e053181e6d26963a58559723e5f8fe672b0a60cd592",
"type": "key"
},
{
"amount": 3000000000000,
"public_key": "1445ecf2dbb357499fc967ef00393ec82ad04d280bfc33115031ce55c13afc5d",
"type": "key"
}
],
"unlock_block_or_timestamp": 660479,
"version": 1
},
"coinbase_transaction_branch": [],
"major_version": 4,
"minor_version": 0,
"nonce": "28c76209",
"previous_block_hash": "8ac5d16188dfde7c208ab8c64c58c6f64dd2befec00e498920f29f30296c1767",
"timestamp": 1631266587,
"transaction_count": 1
},
"transaction_hashes": [
"11162425fffbfca999af3227c102431a52683ee31bb770e517d663ada4b1c9de"
]
},
"raw_transactions": [
{
"extra": "",
"inputs": [
{
"amount": 100000,
"key_image": "10ae35a6a004323d44640ec89322ef7149e13d6bd57d34111230c4b6883eb18e",
"output_indexes": [
20683,
430,
395,
225
],
"type": "key"
},
{
"amount": 955000,
"key_image": "750fa05f975ee72d79e8708ce917e2e1bbc2014762a7d9ce93687e4972dea386",
"output_indexes": [
1033,
45,
57,
444
],
"type": "key"
},
{
"amount": 964000,
"key_image": "5fc89c0897143f55c8fa4f181c5e4f5263b7d0ca6abca0edd6a04dd3ce6024c8",
"output_indexes": [
134,
299,
941,
177
],
"type": "key"
},
{
"amount": 964000,
"key_image": "f7fcc0f7f6e7adeed21ba084d3d50a8368534e94fd7ddd7d6c835db4901f5098",
"output_indexes": [
1310,
231,
9,
7
],
"type": "key"
},
{
"amount": 1000000,
"key_image": "69c9d77902091eb6512495aa2bfdd95ce8373c2aa56269e7a9b1cd394bb6ff46",
"output_indexes": [
789246,
7841,
79,
20
],
"type": "key"
},
{
"amount": 400000000,
"key_image": "f5f74c3d1d7bee1adca019dacb89ad44e9d30ead696168c75d79acaf321610d3",
"output_indexes": [
850671,
2184,
629,
358
],
"type": "key"
},
{
"amount": 500000000,
"key_image": "e0da440b5862e8545c204e5deaefb8f11c8c9ed8c1741bf7638fb16bf86800b9",
"output_indexes": [
921339,
1835,
113,
188
],
"type": "key"
}
],
"outputs": [
{
"amount": 63000,
"encrypted_address_type": "60",
"encrypted_secret": "e257b927ab7a3c59589b22cd6f951155446f540e522f7878151f1e57bb7da35b",
"public_key": "7fe1fc21c1f73822203164bc58912cb3e0b1f3b33735654837e74299fa214e8e",
"type": "key"
},
{
"amount": 1000000000,
"encrypted_address_type": "53",
"encrypted_secret": "b1418006cd547a447f64cd36a08fc7fbbfedbeb840849cb4d67b9677af620848",
"public_key": "fcc4840d354fe3976f83ef441817145d40e8befd0bbffc7d1fbaf79b37ec3354",
"type": "key"
},
{
"amount": 70000000000,
"encrypted_address_type": "cd",
"encrypted_secret": "aa831783edc04ab91f2e7333097c19ef482b39196f09f058c528ab08c32a1707",
"public_key": "1357c429ec9857290b4fef8188fcdf20835434b3b0a8db968a5e3de238c8031c",
"type": "key"
}
],
"unlock_block_or_timestamp": 0,
"version": 4
}
],
"transactions": [
{
"amount": 7983279202,
"anonymity": 0,
"binary_size": 269,
"block_hash": "0012daca5694fd5f228e61144160a0f2c2b9920e467012930b3a67393c607988",
"block_height": 2398925,
"coinbase": true,
"extra": "01db4b1131bc6fb9c96e7f84291aff6947663887e5ea1042a3d11fac9592b2839a0403a08d06",
"fee": 0,
"hash": "89eb3525d61f10dc868e0b23151b27aee14808c75417dc43dff7d22aed1f7f16",
"inputs_hash": "6ec2c9006d228c9aaf5d11798e74159f7612341c9b9a18fe8adf85b88559d80c",
"prefix_hash": "89eb3525d61f10dc868e0b23151b27aee14808c75417dc43dff7d22aed1f7f16",
"public_key": "db4b1131bc6fb9c96e7f84291aff6947663887e5ea1042a3d11fac9592b2839a",
"size": 269,
"timestamp": 1631266587,
"unlock_block_or_timestamp": 0,
"unlock_time": 0
},
{
"amount": 71000063000,
"anonymity": 3,
"binary_size": 4823,
"block_hash": "0012daca5694fd5f228e61144160a0f2c2b9920e467012930b3a67393c607988",
"block_height": 2398925,
"coinbase": false,
"fee": 690000,
"hash": "11162425fffbfca999af3227c102431a52683ee31bb770e517d663ada4b1c9de",
"inputs_hash": "272c3b5045236abee87bd12ad6127239c8ad01e2680b23e36472346b56c86dbb",
"prefix_hash": "c89c3c639723ccd0bc3d12b4457af2519931b8e607682b0f7ed50e7a7b888253",
"size": 4823,
"timestamp": 1631266587,
"unlock_block_or_timestamp": 0,
"unlock_time": 0
}
]
},
{
"header": {
"already_generated_coins": 18444651501810720260,
"already_generated_key_outputs": 63482018,
"already_generated_transactions": 6659693,
"base_reward": 7982558751,
"binary_nonce": "9041a6f3",
"block_capacity_vote": 100000,
"block_capacity_vote_median": 100000,
"block_size": 527,
"cumulative_difficulty": 30627741738754870,
"difficulty": 11941252530,
"effective_size_median": 0,
"hash": "507fadea86c1c5113d77adc497e544e236b6ea081e214792f212a06ffa743869",
"height": 2398926,
"major_version": 4,
"minor_version": 7,
"nonce": 4087759248,
"previous_block_hash": "0012daca5694fd5f228e61144160a0f2c2b9920e467012930b3a67393c607988",
"reward": 7982558751,
"size_median": 0,
"timestamp": 1631266889,
"timestamp_median": 1631263236,
"transactions_fee": 0,
"transactions_size": 268
},
"output_stack_indexes": [
[
1744,
954,
833938,
801324,
1424619,
854653
]
],
"raw_header": {
"coinbase_transaction": {
"extra": "012a5c6d803d1b2573f28a81e4706c5d70b787414ac43106696e35a97ac1f391160403a08d06",
"inputs": [
{
"height": 2398926,
"type": "coinbase"
}
],
"outputs": [
{
"amount": 558000,
"public_key": "699b978a1486238d32c1c6bb562df525e39cac44d2d17533814c9737d753a834",
"type": "key"
},
{
"amount": 751,
"public_key": "7ee00c174ef902209e011ccb21b78eb5a4370b6ce3402a99969c7a196bf53148",
"type": "key"
},
{
"amount": 2000000,
"public_key": "7baf0b59991bb4e4fe9eea9035bb6df872a9c7bb367e2d92e84518d568ac677b",
"type": "key"
},
{
"amount": 80000000,
"public_key": "89f86afd958a21e4d5c0cd7f70167682fcbfb85ca76d239618c4e54bc1a42bfd",
"type": "key"
},
{
"amount": 900000000,
"public_key": "37205f4badcfc037f552aab67f5d29cb388918711d5bbacdeda71f454b6e26c3",
"type": "key"
},
{
"amount": 7000000000,
"public_key": "96ca9a86e8ef567d4edc25a72561b9c5573b7c67365758c60ffb1070ac436663",
"type": "key"
}
],
"unlock_block_or_timestamp": 0,
"version": 1
},
"major_version": 4,
"minor_version": 7,
"previous_block_hash": "0012daca5694fd5f228e61144160a0f2c2b9920e467012930b3a67393c607988",
"root_block": {
"blockchain_branch": [],
"coinbase_transaction": {
"extra": "017727d7f42013bf653a2cbd97c385785eaa37da01c73a50e20a63a14f7e2f832a0211000000a398d9879272d544620000000000032100ff3bb1e5d57d44562ab4e6d7f7a693a40d1949b1f7b89c81fa3ef3ad5eb9be9c",
"ignored": 0,
"inputs": [
{
"height": 2454172,
"type": "coinbase"
}
],
"outputs": [
{
"amount": 3000000000000,
"public_key": "3bb5e0fa2d6e0bf116558fbb35d1c68c95ef423ee0191a6bfc42b2550a79b5f0",
"type": "key"
},
{
"amount": 7000000000000,
"public_key": "a8f5c7211fdd68490784d0013958520adf4e3e088f299671c137bb367923b411",
"type": "key"
}
],
"unlock_block_or_timestamp": 2454232,
"version": 2
},
"coinbase_transaction_branch": [],
"major_version": 60,
"minor_version": 60,
"nonce": "9041a6f3",
"previous_block_hash": "5a95458ebaa3de7697b543a6b6809ad94ea988c4b4fe6112523da367358d8cba",
"timestamp": 1631266889,
"transaction_count": 1
},
"transaction_hashes": []
},
"raw_transactions": [],
"transactions": [
{
"amount": 7982558751,
"anonymity": 0,
"binary_size": 268,
"block_hash": "507fadea86c1c5113d77adc497e544e236b6ea081e214792f212a06ffa743869",
"block_height": 2398926,
"coinbase": true,
"extra": "012a5c6d803d1b2573f28a81e4706c5d70b787414ac43106696e35a97ac1f391160403a08d06",
"fee": 0,
"hash": "8c3527b19b717cdfa52450dfd09e3770aec549929c98d9767ea5b2ea5b2b2b99",
"inputs_hash": "c04073a6ea5b7c6a7c22e20a5ffbb2cd1df82f1344678723ab18b68e1214d78a",
"prefix_hash": "8c3527b19b717cdfa52450dfd09e3770aec549929c98d9767ea5b2ea5b2b2b99",
"public_key": "2a5c6d803d1b2573f28a81e4706c5d70b787414ac43106696e35a97ac1f39116",
"size": 268,
"timestamp": 1631266889,
"unlock_block_or_timestamp": 0,
"unlock_time": 0
}
]
}
],
"start_height": 2398925,
"status": {
"incoming_peer_count": 0,
"lower_level_error": "",
"next_block_effective_median_size": 98872,
"outgoing_peer_count": 8,
"recommended_fee_per_byte": 100,
"recommended_max_transaction_size": 98872,
"top_block_cumulative_difficulty": 30676358330795090,
"top_block_difficulty": 10361588328,
"top_block_hash": "5099fb0b04b83d4f9862109608349d7a25938e6aa00b509366848589fe69917a",
"top_block_height": 2403323,
"top_block_timestamp": 1631799662,
"top_block_timestamp_median": 1631795442,
"top_known_block_height": 2403323,
"transaction_pool_version": 2438
}
}
}
Start Building with GetBlock RPCs for Free
Previous
{ "overview": "Overview", "guides": "Guides", "get-started": "Get Started", "rpc-service": "Nodes Methods", "getblock-explorer": "Explorer API", "getblock-tracker": "Tracker API", "nodes-endpoints": "Nodes Endpoints" }
Next
{ "overview": "Overview", "guides": "Guides", "get-started": "Get Started", "rpc-service": "Nodes Methods", "getblock-explorer": "Explorer API", "getblock-tracker": "Tracker API", "nodes-endpoints": "Nodes Endpoints" }
