Make a REST API request to get the entire wallet history in one shot with the Waterfalls endpoint.
Waterfalls request must contain only the "bitcoin part" of a ct descriptor, in other words the confidential descriptor without the blinding key.
In order to make REST API requests to the Blockstream Explorer Enterprise endpoints you first need to request an access token using your client_id and client_secret.
Note that the access token is the value of the access_token key in the JSON object returned from the token endpoint.
You will use these access tokens in the Authorization section of your REST API requests (Bearer type)
These access tokens expire after 300s (5 min) so you will have to refresh them periodically.
Endpoints: Liquid mainnet: https://enterprise.blockstream.info/liquid/api Liquid testnet: https://enterprise.blockstream.info/liquidtestnet/api
CODE EXAMPLE:
ACCESS_TOKEN=MY_ACCESS_TOKEN CT_DESCRIPTOR_FULL="ct(slip77(2411e278affa5c47010eab6d313c1ec66628ec0dd03b6fc98d1a05a0618719e6),elwpkh([a8874235/84'/1776'/0']xpub6DLHCiTPg67KE9ksCjNVpVHTRDHzhCSmoBTKzp2K4FxLQwQvvdNzuqxhK2f9gFVCN6Dori7j2JMLeDoB4VqswG7Et9tjqauAvbDmzF8NEPH/<0;1>/*))"
CT_DESCRIPTOR_WITHOUT_BLINDING="elwpkh([a8874235/84'/1776'/0']xpub6DLHCiTPg67KE9ksCjNVpVHTRDHzhCSmoBTKzp2K4FxLQwQvvdNzuqxhK2f9gFVCN6Dori7j2JMLeDoB4VqswG7Et9tjqauAvbDmzF8NEPH/<0;1>/*)"
CT_DESCRIPTOR_WITHOUT_BLINDING_ESCAPED="elwpkh%28%5Ba8874235%2F84%27%2F1776%27%2F0%27%5Dxpub6DLHCiTPg67KE9ksCjNVpVHTRDHzhCSmoBTKzp2K4FxLQwQvvdNzuqxhK2f9gFVCN6Dori7j2JMLeDoB4VqswG7Et9tjqauAvbDmzF8NEPH%2F%3C0%3B1%3E%2F%2A%29"
curl
--request GET
--location "https://waterfalls.liquidwebwallet.org/liquid/api/v1/waterfalls?descriptor=$CT_DESCRIPTOR_WITHOUT_BLINDING_ESCAPED"
--header "Authorization: Bearer ${ACCESS_TOKEN}"
RESPONSE:
{"txs_seen":{"elwpkh([a8874235/84'/1776'/0']xpub6DLHCiTPg67KE9ksCjNVpVHTRDHzhCSmoBTKzp2K4FxLQwQvvdNzuqxhK2f9gFVCN6Dori7j2JMLeDoB4VqswG7Et9tjqauAvbDmzF8NEPH/0/*)#7kx3rgrn":[[{"txid":"6ac214c3833ee06f7a30636dac66f0e5c025ece2693cc3f85a8c22fb2dcb2fa1","height":2859778,"block_hash":"2f7499435ae332f8a94e330ad1a28914e560eab5acee430bd50e446a66d89e1a","block_timestamp":1715939108},{"txid":"ff5a21c44cf16e69f2455037adadb5faab15189390482df53e8fcdd2e07347f3","height":2879588,"block_hash":"f39ea35b119d314e2b77b9b6aa31a8592d98cc786c66850e11f67ecc34073158","block_timestamp":1717134068},{"txid":"bcea40dfc86462c5368f2451ffbef6021ee02665d6626834cadee0f9676a7bd4","height":2904668,"block_hash":"759333440d911fbfab40c4f6d572635873bf4cbc9ffd8efaf014b762e733d30b","block_timestamp":1718639935}],[{"txid":"f80937d3834f0395a687a4eee699a43d3a711c7c0ffc2cd2c4c10996c2f1777e","height":2869730,"block_hash":"c181c818096236ac97f582a3c714887b82f9228360a8c502403cb1fdf9255a5b","block_timestamp":1716542408},{"txid":"ddb2d0b67cb83037c9b8eccf4c87cd310c0c3ea55cbee896c510b75d432eac49","height":2879590,"block_hash":"8944a6614055f93062dd5f0703467df8d4aafd58d60e4b96792424c123f92f14","block_timestamp":1717134187},{"txid":"723814d8675d9cce5a4a09c80db1e92303b8f951d873dc8c3e36b8426a2e75f8","height":2904676,"block_hash":"0d4893eafbec1eca40b660b57fd0149391a7776a142116f331f8790f1ac0012c","block_timestamp":1718640428}],[{"txid":"c9ff11095beac7853e035fabe6da72165e8161dcce4bd6ac61e74ad1b95a938c","height":2879703,"block_hash":"318b6c9a973d19cc7efbba964cd478daea588a6801d5cc59702ad677c3534274","block_timestamp":1717140967},{"txid":"bcea40dfc86462c5368f2451ffbef6021ee02665d6626834cadee0f9676a7bd4","height":2904668,"block_hash":"759333440d911fbfab40c4f6d572635873bf4cbc9ffd8efaf014b762e733d30b","block_timestamp":1718639935},{"txid":"723814d8675d9cce5a4a09c80db1e92303b8f951d873dc8c3e36b8426a2e75f8","height":2904676,"block_hash":"0d4893eafbec1eca40b660b57fd0149391a7776a142116f331f8790f1ac0012c","block_timestamp":1718640428}],[{"txid":"723814d8675d9cce5a4a09c80db1e92303b8f951d873dc8c3e36b8426a2e75f8","height":2904676,"block_hash":"0d4893eafbec1eca40b660b57fd0149391a7776a142116f331f8790f1ac0012c","block_timestamp":1718640428},{"txid":"634baa344b18aded22b566f40f81fa41719099950264d180d1e85d5e190e1179","height":3199359,"block_hash":"8acabbd8b551cb3ce9aa158e66103f2550445b6e49930394e03fa4f44fc4ad79","block_timestamp":1736419208}],[{"txid":"5d28de782b656c24a9b568b15394dbe337c1a7bc2a5a2797bc0ccb0779afc225","height":3018965,"block_hash":"b91a429c78a441d126683ba548f1953f940f9fe6d595b9e5dcbf7f31e40258ac","block_timestamp":1725553268},{"txid":"3997e474d8608759f8d1304d28916d7c2e7a5898c4383d1db586a3ee340bfe4f","height":3198291,"block_hash":"7f3f29ed23a849057c4c7c8a9aea4010e9ab2e8908380376ca0f6746a6bbd80d","block_timestamp":1736355130}],[{"txid":"3997e474d8608759f8d1304d28916d7c2e7a5898c4383d1db586a3ee340bfe4f","height":3198291,"block_hash":"7f3f29ed23a849057c4c7c8a9aea4010e9ab2e8908380376ca0f6746a6bbd80d","block_timestamp":1736355130},{"txid":"a8b7ca790830c88379a9df6f341fecace2402896755875ca6a5b1980fc9bd169","height":3199279,"block_hash":"4ac5ae418f155fa7a88e6634b4c223091b41b5ee9448a9981291f09a1f4e64f0","block_timestamp":1736414410}],[{"txid":"a8b7ca790830c88379a9df6f341fecace2402896755875ca6a5b1980fc9bd169","height":3199279,"block_hash":"4ac5ae418f155fa7a88e6634b4c223091b41b5ee9448a9981291f09a1f4e64f0","block_timestamp":1736414410},{"txid":"a0968aca9ed4a16954e507dff0831707d82b3a8fa06b4c1eeb9746ff63d62c65","height":3199315,"block_hash":"2946936afa4464023b6e5b0c6a3fb8b3f54f60f46fec0aa7e1f94cd88b737898","block_timestamp":1736416568}],[{"txid":"a0968aca9ed4a16954e507dff0831707d82b3a8fa06b4c1eeb9746ff63d62c65","height":3199315,"block_hash":"2946936afa4464023b6e5b0c6a3fb8b3f54f60f46fec0aa7e1f94cd88b737898","block_timestamp":1736416568},{"txid":"634baa344b18aded22b566f40f81fa41719099950264d180d1e85d5e190e1179","height":3199359,"block_hash":"8acabbd8b551cb3ce9aa158e66103f2550445b6e49930394e03fa4f44fc4ad79","block_timestamp":1736419208}],[{"txid":"634baa344b18aded22b566f40f81fa41719099950264d180d1e85d5e190e1179","height":3199359,"block_hash":"8acabbd8b551cb3ce9aa158e66103f2550445b6e49930394e03fa4f44fc4ad79","block_timestamp":1736419208}],[{"txid":"ae7cd9098c5ee4af9da9e0ed1d119b9cc58a50c803b24de4d0ff068b03bd5151","height":3199518,"block_hash":"e2fa378b268124c321cd27933535b8333c3ea4c2aee5b385e10312b6a3c61280","block_timestamp":1736428748}],[{"txid":"1f0504fecd0c9e3864f7ad68fd9acb0ca1c30047ead44089d98e08304ccc03dd","height":3277050,"block_hash":"c46702b37f26be215d5c0c8cb7675653d78b708441e35bd06fbfa3bb90a08d16","block_timestamp":1741095968},{"txid":"6e5e61a0462a6ab2d6c32b00efceb9bdbe05fa33884d0a6c2fa74143b105e2ef","height":3277153,"block_hash":"cbdff7a2250eab5a30f0d592debb60e8b456d6549700c7c2d84b8632c80ec2a5","block_timestamp":1741102150}],[{"txid":"1f0504fecd0c9e3864f7ad68fd9acb0ca1c30047ead44089d98e08304ccc03dd","height":3277050,"block_hash":"c46702b37f26be215d5c0c8cb7675653d78b708441e35bd06fbfa3bb90a08d16","block_timestamp":1741095968},{"txid":"cbae3010550cb6f9cd17923026e095b20c34dc964d668e47c7c78a2354ec2601","height":3277054,"block_hash":"d1f4b552b0e11f0806fe9d420b103ea91abf69d56e24b0543404658737abf136","block_timestamp":1741096210}],[{"txid":"cbae3010550cb6f9cd17923026e095b20c34dc964d668e47c7c78a2354ec2601","height":3277054,"block_hash":"d1f4b552b0e11f0806fe9d420b103ea91abf69d56e24b0543404658737abf136","block_timestamp":1741096210}],[{"txid":"3338f3c014a9790cd2b1395d9f568b77c1032d85f8e75b03c1f15c19247b0228","height":3277190,"block_hash":"620144d083bc5520afd906edee89e3ec42e39ac880347bb43550136e9c2e9f91","block_timestamp":1741104370}],[{"txid":"144c5515072a48d4afac3d24d1853cdcaf92ee9341b5b1f51dcd2f70be0a53ee","height":3391730,"block_hash":"6b1c3f2ab15d55a7da96a2aaaa86f02184eeb84256f5bf8d15957b7f789c2d41","block_timestamp":1748353510}],[{"txid":"1bf1076f1bbd8456faf8160b6c7767b9dce4d858fc080e8ac6e7836ab06dde3d","height":3391731,"block_hash":"1565db72a36d3ead940c3c27441aad56f091106f6b1ea9ae89d0f9ac4f19ea1d","block_timestamp":1748353570}],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[]],"elwpkh([a8874235/84'/1776'/0']xpub6DLHCiTPg67KE9ksCjNVpVHTRDHzhCSmoBTKzp2K4FxLQwQvvdNzuqxhK2f9gFVCN6Dori7j2JMLeDoB4VqswG7Et9tjqauAvbDmzF8NEPH/1/*)#0zrs7ant":[[{"txid":"bcea40dfc86462c5368f2451ffbef6021ee02665d6626834cadee0f9676a7bd4","height":2904668,"block_hash":"759333440d911fbfab40c4f6d572635873bf4cbc9ffd8efaf014b762e733d30b","block_timestamp":1718639935},{"txid":"723814d8675d9cce5a4a09c80db1e92303b8f951d873dc8c3e36b8426a2e75f8","height":2904676,"block_hash":"0d4893eafbec1eca40b660b57fd0149391a7776a142116f331f8790f1ac0012c","block_timestamp":1718640428}],[{"txid":"723814d8675d9cce5a4a09c80db1e92303b8f951d873dc8c3e36b8426a2e75f8","height":2904676,"block_hash":"0d4893eafbec1eca40b660b57fd0149391a7776a142116f331f8790f1ac0012c","block_timestamp":1718640428},{"txid":"3997e474d8608759f8d1304d28916d7c2e7a5898c4383d1db586a3ee340bfe4f","height":3198291,"block_hash":"7f3f29ed23a849057c4c7c8a9aea4010e9ab2e8908380376ca0f6746a6bbd80d","block_timestamp":1736355130}],[{"txid":"3997e474d8608759f8d1304d28916d7c2e7a5898c4383d1db586a3ee340bfe4f","height":3198291,"block_hash":"7f3f29ed23a849057c4c7c8a9aea4010e9ab2e8908380376ca0f6746a6bbd80d","block_timestamp":1736355130},{"txid":"a8b7ca790830c88379a9df6f341fecace2402896755875ca6a5b1980fc9bd169","height":3199279,"block_hash":"4ac5ae418f155fa7a88e6634b4c223091b41b5ee9448a9981291f09a1f4e64f0","block_timestamp":1736414410}],[{"txid":"a8b7ca790830c88379a9df6f341fecace2402896755875ca6a5b1980fc9bd169","height":3199279,"block_hash":"4ac5ae418f155fa7a88e6634b4c223091b41b5ee9448a9981291f09a1f4e64f0","block_timestamp":1736414410},{"txid":"a0968aca9ed4a16954e507dff0831707d82b3a8fa06b4c1eeb9746ff63d62c65","height":3199315,"block_hash":"2946936afa4464023b6e5b0c6a3fb8b3f54f60f46fec0aa7e1f94cd88b737898","block_timestamp":1736416568}],[{"txid":"a0968aca9ed4a16954e507dff0831707d82b3a8fa06b4c1eeb9746ff63d62c65","height":3199315,"block_hash":"2946936afa4464023b6e5b0c6a3fb8b3f54f60f46fec0aa7e1f94cd88b737898","block_timestamp":1736416568},{"txid":"634baa344b18aded22b566f40f81fa41719099950264d180d1e85d5e190e1179","height":3199359,"block_hash":"8acabbd8b551cb3ce9aa158e66103f2550445b6e49930394e03fa4f44fc4ad79","block_timestamp":1736419208}],[{"txid":"634baa344b18aded22b566f40f81fa41719099950264d180d1e85d5e190e1179","height":3199359,"block_hash":"8acabbd8b551cb3ce9aa158e66103f2550445b6e49930394e03fa4f44fc4ad79","block_timestamp":1736419208},{"txid":"ae7cd9098c5ee4af9da9e0ed1d119b9cc58a50c803b24de4d0ff068b03bd5151","height":3199518,"block_hash":"e2fa378b268124c321cd27933535b8333c3ea4c2aee5b385e10312b6a3c61280","block_timestamp":1736428748}],[{"txid":"634baa344b18aded22b566f40f81fa41719099950264d180d1e85d5e190e1179","height":3199359,"block_hash":"8acabbd8b551cb3ce9aa158e66103f2550445b6e49930394e03fa4f44fc4ad79","block_timestamp":1736419208},{"txid":"ae7cd9098c5ee4af9da9e0ed1d119b9cc58a50c803b24de4d0ff068b03bd5151","height":3199518,"block_hash":"e2fa378b268124c321cd27933535b8333c3ea4c2aee5b385e10312b6a3c61280","block_timestamp":1736428748}],[{"txid":"ae7cd9098c5ee4af9da9e0ed1d119b9cc58a50c803b24de4d0ff068b03bd5151","height":3199518,"block_hash":"e2fa378b268124c321cd27933535b8333c3ea4c2aee5b385e10312b6a3c61280","block_timestamp":1736428748}],[{"txid":"ae7cd9098c5ee4af9da9e0ed1d119b9cc58a50c803b24de4d0ff068b03bd5151","height":3199518,"block_hash":"e2fa378b268124c321cd27933535b8333c3ea4c2aee5b385e10312b6a3c61280","block_timestamp":1736428748},{"txid":"1f0504fecd0c9e3864f7ad68fd9acb0ca1c30047ead44089d98e08304ccc03dd","height":3277050,"block_hash":"c46702b37f26be215d5c0c8cb7675653d78b708441e35bd06fbfa3bb90a08d16","block_timestamp":1741095968}],[{"txid":"1f0504fecd0c9e3864f7ad68fd9acb0ca1c30047ead44089d98e08304ccc03dd","height":3277050,"block_hash":"c46702b37f26be215d5c0c8cb7675653d78b708441e35bd06fbfa3bb90a08d16","block_timestamp":1741095968},{"txid":"cbae3010550cb6f9cd17923026e095b20c34dc964d668e47c7c78a2354ec2601","height":3277054,"block_hash":"d1f4b552b0e11f0806fe9d420b103ea91abf69d56e24b0543404658737abf136","block_timestamp":1741096210}],[{"txid":"cbae3010550cb6f9cd17923026e095b20c34dc964d668e47c7c78a2354ec2601","height":3277054,"block_hash":"d1f4b552b0e11f0806fe9d420b103ea91abf69d56e24b0543404658737abf136","block_timestamp":1741096210},{"txid":"3338f3c014a9790cd2b1395d9f568b77c1032d85f8e75b03c1f15c19247b0228","height":3277190,"block_hash":"620144d083bc5520afd906edee89e3ec42e39ac880347bb43550136e9c2e9f91","block_timestamp":1741104370}],[{"txid":"cbae3010550cb6f9cd17923026e095b20c34dc964d668e47c7c78a2354ec2601","height":3277054,"block_hash":"d1f4b552b0e11f0806fe9d420b103ea91abf69d56e24b0543404658737abf136","block_timestamp":1741096210},{"txid":"6e5e61a0462a6ab2d6c32b00efceb9bdbe05fa33884d0a6c2fa74143b105e2ef","height":3277153,"block_hash":"cbdff7a2250eab5a30f0d592debb60e8b456d6549700c7c2d84b8632c80ec2a5","block_timestamp":1741102150}],[{"txid":"6e5e61a0462a6ab2d6c32b00efceb9bdbe05fa33884d0a6c2fa74143b105e2ef","height":3277153,"block_hash":"cbdff7a2250eab5a30f0d592debb60e8b456d6549700c7c2d84b8632c80ec2a5","block_timestamp":1741102150}],[{"txid":"6e5e61a0462a6ab2d6c32b00efceb9bdbe05fa33884d0a6c2fa74143b105e2ef","height":3277153,"block_hash":"cbdff7a2250eab5a30f0d592debb60e8b456d6549700c7c2d84b8632c80ec2a5","block_timestamp":1741102150},{"txid":"3338f3c014a9790cd2b1395d9f568b77c1032d85f8e75b03c1f15c19247b0228","height":3277190,"block_hash":"620144d083bc5520afd906edee89e3ec42e39ac880347bb43550136e9c2e9f91","block_timestamp":1741104370}],[{"txid":"3338f3c014a9790cd2b1395d9f568b77c1032d85f8e75b03c1f15c19247b0228","height":3277190,"block_hash":"620144d083bc5520afd906edee89e3ec42e39ac880347bb43550136e9c2e9f91","block_timestamp":1741104370}],[{"txid":"3338f3c014a9790cd2b1395d9f568b77c1032d85f8e75b03c1f15c19247b0228","height":3277190,"block_hash":"620144d083bc5520afd906edee89e3ec42e39ac880347bb43550136e9c2e9f91","block_timestamp":1741104370}],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[],[]]},"page":0}