Documentation
General
Addresses
Transactions
Mempool
Below is a reference for the Bitcoin Websocket service running at wss://lightning.btc.tx.taxi/api/v1/ws.
General
Live Data general
Description
Subscribe to live data. Available:
blocks, mempool-block, live-2h-chart, and stats.Payload
{ "action": "want", "data": ["mempool-blocks", "stats"] }Response
{
"mempool-blocks": [
{
"blockSize": 1801614,
"blockVSize": 997936.5,
"nTx": 3391,
"totalFees": 8170664,
"medianFee": 6.011217160720601,
"feeRange": [
4.584615384615384,
5,
5.100456621004566,
6.002319288751449,
7.235398230088496,
10.377668308702791,
200
]
},
...
{
"blockSize": 198543075,
"blockVSize": 101691348,
"nTx": 249402,
"totalFees": 135312667,
"medianFee": 1.2559438783834156,
"feeRange": [
1.000685629033809,
1.0020213063577312,
1.0019080827758888,
1.0227913345013278,
1.1188648002395873,
1.2559438783834156,
1.4077952614964329,
1.4079805737077244,
1.5106880342499638,
2.003440424869914,
2.2713888268854894
]
}
],
"mempoolInfo": {
"loaded": true,
"size": 264505,
"bytes": 108875402,
"usage": 649908688,
"total_fee": 1.61036575,
"maxmempool": 300000000,
"mempoolminfee": 0.00001858,
"minrelaytxfee": 0.00001,
"incrementalrelayfee": 0.00001,
"unbroadcastcount": 0,
"fullrbf": true
},
"vBytesPerSecond": 1651,
"fees": {
"fastestFee": 7,
"halfHourFee": 6,
"hourFee": 5,
"economyFee": 4,
"minimumFee": 2
},
"da": {
"progressPercent": 32.49007936507937,
"difficultyChange": 0.7843046881601534,
"estimatedRetargetDate": 1735514828279,
"remainingBlocks": 1361,
"remainingTime": 811481279,
"previousRetarget": 4.429396745461176,
"previousTime": 1734312810,
"nextRetargetHeight": 876960,
"timeAvg": 596239,
"adjustedTimeAvg": 596239,
"timeOffset": 0,
"expectedBlocks": 650.895
}
}Addresses
Track Address addresses
Description
Subscribe to a single address to receive live updates on new transactions having that address in input or output.
address-transactions field contains new mempool transactions, and block-transactions contains new confirmed transactions.Payload
{ "track-address": "bc1qeldw4mqns26wew8swgpkt3fs364w3ehs046w2f" }Response
{
"block-transactions": [
{
"txid": "9d3ea0d131c45450c135d549b62032019bc47a80368e14edc72caf38f5a88033",
"version": 1,
"locktime": 0,
"vin": [
{
"txid": "69da555a9c69788a3a081958457894e56b1ee6766bc72cecf881b1b4f327f78b",
"vout": 0,
"prevout": {
"scriptpubkey": "a914c9848245ae4f5d5934b5cbdfb79e04cdd337470b87",
"scriptpubkey_asm": "OP_HASH160 OP_PUSHBYTES_20 c9848245ae4f5d5934b5cbdfb79e04cdd337470b OP_EQUAL",
"scriptpubkey_type": "p2sh",
"scriptpubkey_address": "3L4YUynB4X44rJBY9CmiLMN8Wjti49JCYB",
"value": 24962957
},
"scriptsig": "0048304502210099219ee0cd5da341650078e3c63885b3cc2211069f2551cf436e0100f421e1760220349b4ec284255b458d6da539fa17314e8330459e0a653c254f775d4ec8f32b3f0147304402203a8353c5ee76a2e266432e5f993f882e05725297e64c0833cf44719f7dda8d3b022058a2f72e7739efd21657b4943cac60a0a3c749e712787f0e85726da4c3adcf8e014c695221027f2a0df8e86535d08ca3e766a178f90c813d2dd1d55b0166e82518efbffb18c02103556a35844b517e2fc8216701e2e0a64dbcbe62ad420ac6dd73dc79e69efeb69521031ef21bd55171032b7aec21ec82932735fb986f1d4d8611feee62ab38acf4a6bb53ae",
"scriptsig_asm": "OP_0 OP_PUSHBYTES_72 304502210099219ee0cd5da341650078e3c63885b3cc2211069f2551cf436e0100f421e1760220349b4ec284255b458d6da539fa17314e8330459e0a653c254f775d4ec8f32b3f01 OP_PUSHBYTES_71 304402203a8353c5ee76a2e266432e5f993f882e05725297e64c0833cf44719f7dda8d3b022058a2f72e7739efd21657b4943cac60a0a3c749e712787f0e85726da4c3adcf8e01 OP_PUSHDATA1 5221027f2a0df8e86535d08ca3e766a178f90c813d2dd1d55b0166e82518efbffb18c02103556a35844b517e2fc8216701e2e0a64dbcbe62ad420ac6dd73dc79e69efeb69521031ef21bd55171032b7aec21ec82932735fb986f1d4d8611feee62ab38acf4a6bb53ae",
"is_coinbase": false,
"sequence": 4294967295,
"inner_redeemscript_asm": "OP_PUSHNUM_2 OP_PUSHBYTES_33 027f2a0df8e86535d08ca3e766a178f90c813d2dd1d55b0166e82518efbffb18c0 OP_PUSHBYTES_33 03556a35844b517e2fc8216701e2e0a64dbcbe62ad420ac6dd73dc79e69efeb695 OP_PUSHBYTES_33 031ef21bd55171032b7aec21ec82932735fb986f1d4d8611feee62ab38acf4a6bb OP_PUSHNUM_3 OP_CHECKMULTISIG"
},
...
{
"txid": "43852d32c7ae6d362d446d090daa4d389f78ec77e6693f9248cd924dc0b1ecc3",
"vout": 1,
"prevout": {
"scriptpubkey": "a914a3aff5f5765f167c1582fd85517ddde83174118187",
"scriptpubkey_asm": "OP_HASH160 OP_PUSHBYTES_20 a3aff5f5765f167c1582fd85517ddde831741181 OP_EQUAL",
"scriptpubkey_type": "p2sh",
"scriptpubkey_address": "3GcWrnGFoNzbn1KaiP5czS5xPELdWcgDX2",
"value": 1719827
},
"scriptsig": "0047304402205f83d22a0476158aa0986682c96ce2b2dab26c814968dba62905cdfeef1b3ac7022059438a3439bb18bd49242010c8a276ea6f1810d523042e679fa6679d60e89e0201483045022100eb085df09e0fb4894090a5f39b9f2188392f7ac2847ed8255629baffc7371f170220120463b91d6c4bb8968fb3eda9012b88d13d8ca71de28e7a64b1dd88282ff144014c69522103650083cbc9cd1da1224e0780bce1ee8abd5150c5252defd0edeccd3521610b282102510ab30a6a97464ef0d61f71ec8b1d2325f12934ff15ba73579bfd0ac5f4fc1a2102985b3be77f56a9a29c5f68d3c893d6c4d76ec8c07792f0291d375c29b71ee2f853ae",
"scriptsig_asm": "OP_0 OP_PUSHBYTES_71 304402205f83d22a0476158aa0986682c96ce2b2dab26c814968dba62905cdfeef1b3ac7022059438a3439bb18bd49242010c8a276ea6f1810d523042e679fa6679d60e89e0201 OP_PUSHBYTES_72 3045022100eb085df09e0fb4894090a5f39b9f2188392f7ac2847ed8255629baffc7371f170220120463b91d6c4bb8968fb3eda9012b88d13d8ca71de28e7a64b1dd88282ff14401 OP_PUSHDATA1 522103650083cbc9cd1da1224e0780bce1ee8abd5150c5252defd0edeccd3521610b282102510ab30a6a97464ef0d61f71ec8b1d2325f12934ff15ba73579bfd0ac5f4fc1a2102985b3be77f56a9a29c5f68d3c893d6c4d76ec8c07792f0291d375c29b71ee2f853ae",
"is_coinbase": false,
"sequence": 4294967295,
"inner_redeemscript_asm": "OP_PUSHNUM_2 OP_PUSHBYTES_33 03650083cbc9cd1da1224e0780bce1ee8abd5150c5252defd0edeccd3521610b28 OP_PUSHBYTES_33 02510ab30a6a97464ef0d61f71ec8b1d2325f12934ff15ba73579bfd0ac5f4fc1a OP_PUSHBYTES_33 02985b3be77f56a9a29c5f68d3c893d6c4d76ec8c07792f0291d375c29b71ee2f8 OP_PUSHNUM_3 OP_CHECKMULTISIG"
}
],
"vout": [
{
"scriptpubkey": "0014292fce548b228cd3df6334dd525fac62e7eb5f7a",
"scriptpubkey_asm": "OP_0 OP_PUSHBYTES_20 292fce548b228cd3df6334dd525fac62e7eb5f7a",
"scriptpubkey_type": "v0_p2wpkh",
"scriptpubkey_address": "bc1q9yhuu4yty2xd8hmrxnw4yhavvtn7khm62uw38p",
"value": 57000
},
...
{
"scriptpubkey": "0020e5c7c00d174631d2d1e365d6347b016fb87b6a0c08902d8e443989cb771fa7ec",
"scriptpubkey_asm": "OP_0 OP_PUSHBYTES_32 e5c7c00d174631d2d1e365d6347b016fb87b6a0c08902d8e443989cb771fa7ec",
"scriptpubkey_type": "v0_p2wsh",
"scriptpubkey_address": "bc1quhruqrghgcca950rvhtrg7cpd7u8k6svpzgzmrjy8xyukacl5lkq0r8l2d",
"value": 17343523
}
],
"size": 5514,
"weight": 22056,
"sigops": 208,
"fee": 44000,
"status": {
"confirmed": true,
"block_height": 875602,
"block_hash": "000000000000000000016c0639b6c1a34d6659c231aa2de5849ab3377ed75020",
"block_time": 1734704791
},
"order": 864069877,
"vsize": 5514,
"adjustedVsize": 5514,
"feePerVsize": 7.979688066739209,
"adjustedFeePerVsize": 7.979688066739209,
"effectiveFeePerVsize": 7.979688066739209,
"firstSeen": 1734704590,
"inputs": [],
"cpfpDirty": false,
"ancestors": [],
"descendants": [],
"bestDescendant": null,
"position": {
"block": 0,
"vsize": 191567
},
"flags": 1099511659526
}
]
}Track Addresses addresses
Description
Subscribe to multiple addresses to receive live updates on new transactions having these addresses in input or output. Limits on the maximum number of tracked addresses apply. For higher tracking limits, consider a tx.taxi Enterprise plan.
Payload
{
"track-addresses": [
"bc1qeldw4mqns26wew8swgpkt3fs364w3ehs046w2f",
"bc1qjj09853tfpztjgrk4jeyzj4ml59fv9cmslv3c4gxxf57u0k3kxmqllx29y"
]
}Response
{
"multi-address-transactions": {
"bc1qjj09853tfpztjgrk4jeyzj4ml59fv9cmslv3c4gxxf57u0k3kxmqllx29y": {
"mempool": [],
"confirmed": [
{
"txid": "1e4764f908f19b74284a889478b95d013c1bd36dc832dcb7eb36fe1801fed404",
"version": 2,
"locktime": 875625,
"vin": [
{
"txid": "ce361fed5996aec6d440556383164e9e4e5b8be8c2a213c4b36ae711efda3b3f",
"vout": 1,
"prevout": {
"scriptpubkey": "0014257ba1ebc987831dbe8ee560419282483bf68588",
"scriptpubkey_asm": "OP_0 OP_PUSHBYTES_20 257ba1ebc987831dbe8ee560419282483bf68588",
"scriptpubkey_type": "v0_p2wpkh",
"scriptpubkey_address": "bc1qy4a6r67fs7p3m05wu4syry5zfqaldpvg8vsqzz",
"value": 1831200
},
"scriptsig": "",
"scriptsig_asm": "",
"witness": [
"3044022028363f66fe74bdddf46d204cbf9844d4ef99d6fcb801f93f3ea1666ff51514340220058eb99790dd002323bd12afa0b62903cf72465d48c40cb11366dfa4eebbd87a01",
"020e625e13a81995f29ee828e31500b8454bd0b115f84dfa07d994eecd733efffa"
],
"is_coinbase": false,
"sequence": 4294967294
},
...
],
"vout": [
{
"scriptpubkey": "0020949e53d22b4844b92076acb2414abbfd0a96171b87d91c55063269ee3ed1b1b6",
"scriptpubkey_asm": "OP_0 OP_PUSHBYTES_32 949e53d22b4844b92076acb2414abbfd0a96171b87d91c55063269ee3ed1b1b6",
"scriptpubkey_type": "v0_p2wsh",
"scriptpubkey_address": "bc1qjj09853tfpztjgrk4jeyzj4ml59fv9cmslv3c4gxxf57u0k3kxmqllx29y",
"value": 2546637
}
],
"size": 351,
"weight": 756,
"sigops": 2,
"fee": 4206,
"status": {
"confirmed": true,
"block_height": 875626,
"block_hash": "0000000000000000000086de1f4815ff0f7f0411d846301c5efa1e437130dc22",
"block_time": 1734720142
},
"order": 81067521,
"vsize": 189,
"adjustedVsize": 189,
"feePerVsize": 22.253968253968253,
"adjustedFeePerVsize": 22.253968253968253,
"effectiveFeePerVsize": 22.253968253968253,
"firstSeen": 1734719830,
"inputs": [],
"cpfpDirty": false,
"ancestors": [],
"descendants": [],
"bestDescendant": null,
"position": {
"block": 0,
"vsize": 134866.5
},
"flags": 1099511640074
}
],
"removed": []
}
}
}Transactions
Track Transaction transactions
Description
Subscribe to a transaction to receive live updates on its confirmation status and position in the mempool.
Payload
{ "track-tx": "8a4666c6d22ce74fa47e1c4fdb09af556a234cc6a606539a75caf66ba44a2d07" }Response
{
"txPosition": {
"txid": [
"8a4666c6d22ce74fa47e1c4fdb09af556a234cc6a606539a75caf66ba44a2d07"
],
"position": {
"block": 0,
"vsize": 726868
},
"cpfp": {
"ancestors": [
{
"txid": "d509a6b8f36149588f9f48dc25fa5e37fc00dee781aed6da1113066c56f04879",
"fee": 605,
"weight": 520
}
],
"bestDescendant": null,
"descendants": [
{
"txid": "28d3c592a9a8103d53c784aa539908f4dc5f9c463e179f0eae5dc5f349bdb00f",
"fee": 2501,
"weight": 816
}
],
"effectiveFeePerVsize": 5.12063778580024,
"sigops": 0,
"adjustedVsize": 130
}
}
}Track Transactions transactions
Description
Subscribe to multiple transactions to receive live updates on their status and position in the mempool. Limits on the maximum number of tracked addresses apply. For higher tracking limits, consider a tx.taxi Enterprise plan.
Payload
{
"track-txs": [
"8a4666c6d22ce74fa47e1c4fdb09af556a234cc6a606539a75caf66ba44a2d07",
"941df06064c290b4627e92bdbf3bff7c0e97aab33e273c2a20404f9cfd21b607"
]
}Response
{
"tracked-txs": {
"8a4666c6d22ce74fa47e1c4fdb09af556a234cc6a606539a75caf66ba44a2d07": {
"position": {
"block": 0,
"vsize": 434494
},
"cpfp": {
"ancestors": [
{
"txid": "d509a6b8f36149588f9f48dc25fa5e37fc00dee781aed6da1113066c56f04879",
"fee": 605,
"weight": 520
}
],
"bestDescendant": null,
"descendants": [
{
"txid": "28d3c592a9a8103d53c784aa539908f4dc5f9c463e179f0eae5dc5f349bdb00f",
"fee": 2501,
"weight": 816
}
],
"effectiveFeePerVsize": 5.12063778580024,
"sigops": 0,
"adjustedVsize": 130
}
},
"941df06064c290b4627e92bdbf3bff7c0e97aab33e273c2a20404f9cfd21b607": {
"position": {
"block": 2,
"vsize": 932479.5
}
}
}
}Mempool
Track Mempool mempool
Description
Subscribe to new mempool events, such as new transactions entering the mempool. Available fields:
Because this is potentially a lot of data, consider using the
added, removed, mined, replaced. Because this is potentially a lot of data, consider using the
track-mempool-txids endpoint described below instead, or consider a tx.taxi Enterprise plan.Payload
{ "track-mempool": true }Response
{
"mempool-transactions": {
"sequence": 81419,
"added": [
{
"txid": "6229c0784bc776be22a5ee84e0e3d9b8f9e17843f079a8444b03bdc98b77d229",
"version": 2,
"locktime": 0,
"vin": [
{
"txid": "b4b324e3bff7ee0a7e664e8c03df1fe3a0bd53e5685ea6b10abb5f89ba1b2ead",
"vout": 5,
"prevout": {
"scriptpubkey": "76a914b54afb58f0faa9d1bde2ed755bc56ef1e4a4e24188ac",
"scriptpubkey_asm": "OP_DUP OP_HASH160 OP_PUSHBYTES_20 b54afb58f0faa9d1bde2ed755bc56ef1e4a4e241 OP_EQUALVERIFY OP_CHECKSIG",
"scriptpubkey_type": "p2pkh",
"scriptpubkey_address": "1HXb8YtsgBhFWdYezjd6bt7Dw4UGKyZo54",
"value": 17000
},
"scriptsig": "4830450221008e9b91aae7b4705841c97dc99d6ab233f10ff9b97d7c139be08634d2f0f5f66f02205d67eae8c830ed0979e169403d13c0f43efd78edbb9a344390245f5a83649404012103cf9fad8b202384de9ef010129a62b8249920a6205fe53cc0efbea9eb0db595e7",
"scriptsig_asm": "OP_PUSHBYTES_72 30450221008e9b91aae7b4705841c97dc99d6ab233f10ff9b97d7c139be08634d2f0f5f66f02205d67eae8c830ed0979e169403d13c0f43efd78edbb9a344390245f5a8364940401 OP_PUSHBYTES_33 03cf9fad8b202384de9ef010129a62b8249920a6205fe53cc0efbea9eb0db595e7",
"is_coinbase": false,
"sequence": 4294967293
}
],
"vout": [
{
"scriptpubkey": "76a91401603bd82a5d5a6e8c6df5d9ae662b9fc5db60f288ac",
"scriptpubkey_asm": "OP_DUP OP_HASH160 OP_PUSHBYTES_20 01603bd82a5d5a6e8c6df5d9ae662b9fc5db60f2 OP_EQUALVERIFY OP_CHECKSIG",
"scriptpubkey_type": "p2pkh",
"scriptpubkey_address": "18GxdcLgNtRUc8v5TNJtPnvoi8jMVWxvb",
"value": 10419
},
{
"scriptpubkey": "76a914338ad842d236486627834bf9f5e182c7a8aa937188ac",
"scriptpubkey_asm": "OP_DUP OP_HASH160 OP_PUSHBYTES_20 338ad842d236486627834bf9f5e182c7a8aa9371 OP_EQUALVERIFY OP_CHECKSIG",
"scriptpubkey_type": "p2pkh",
"scriptpubkey_address": "15hXntT6oUKNhtk4FWvuGPQJDX47wpbAaa",
"value": 5396
}
],
"size": 226,
"weight": 904,
"sigops": 8,
"fee": 1185,
"status": {
"confirmed": false
},
"order": 701659019,
"vsize": 226,
"adjustedVsize": 226,
"feePerVsize": 5.243362831858407,
"adjustedFeePerVsize": 5.243362831858407,
"effectiveFeePerVsize": 5.243362831858407,
"firstSeen": 1734893382,
"uid": 429139,
"inputs": [],
"cpfpDirty": false,
"ancestors": [],
"descendants": [],
"bestDescendant": null,
"position": {
"block": 0,
"vsize": 125270
},
"flags": 1099511628809
},
...
],
"removed": [],
"mined": [],
"replaced": []
}
}Track Mempool Txids mempool
Description
Low-bandwith substitute to the above command
track-mempool: subscribe to new mempool events, such as new transactions entering the mempool, but only transaction IDs are returned to save bandwith. Available fields: added, removed, mined, replaced.Payload
{ "track-mempool-txids": true }Response
{
"mempool-txids": {
"sequence": 79919,
"added": [
"4bbb648ab194aaaf9188bccc6efcdcbb59c8485115a7384972c8287782206a0f",
"f7883f3784829d1e741e696bdceec488eeb53fe0b69b0eca574ac9f2e7e8e117",
"784e8e3b182c29798660bf42befb5c6479148c7d90c0d6eea032b89418e7cc3b",
"d3920a7be05269d859bd89b08a6546dc6d6dd523dbc5f7b62b9c0c5eedc43292",
"de6078d584cb5f4a27c3f0bb3d8bbb16b3d5f8303237391f390d0ee9e84d0099",
"39fcbd6e0ec0ad49405f19c72bb033f578147181b77dbe47044f80b0b7604ab5",
"47ed060004fab3fb5fa4885008aa2cadbe3335655f1303231abfe89b4b0c9bd9"
],
"removed": [],
"mined": [],
"replaced": []
}
}Track Mempool Block mempool
Description
Subscribe to live mempool projected block template, index 0 being the first mempool block.
A full set of stripped transactions in that block is returned when the subscription starts, and deltas (removed and added transactions) are then sent every time the mempool changes.
A full set of stripped transactions in that block is returned when the subscription starts, and deltas (removed and added transactions) are then sent every time the mempool changes.
Payload
{ "track-mempool-block": 0 }Response
{
"projected-block-transactions": {
"index": 0,
"sequence": 80270,
"delta": {
"added": [
[
"172b34fb099d80f61b65d1c107c4f25665c8f50e30c1371b2e6fbced62991d58",
2000,
171.25,
5942725,
11.68,
1099511631877,
1734881537
],
...
],
"removed": [
"956a6eee382214631c3299e0410565e05fbd6328c89fa746efab6371705aca2a",
...
],
"changed": []
}
}
}Track Mempool RBF Transactions mempool
Description
Subscribe to new RBF events.
Payload
{ "track-rbf": "all" }Response
{
"rbfLatest": [
{
"tx": {
"txid": "cc6cb210f7ec32660fe4d46984ef64b64143fb02dc7ed70578c32b5f338ef6d6",
"fee": 8280,
"vsize": 204,
"value": 156397,
"rate": 10,
"time": 1734876576,
"rbf": true,
"fullRbf": false
},
"time": 1734876576,
"fullRbf": false,
"replaces": [
{
"tx": {
"txid": "4e94c23e075cf9c2b4ccaf32e3652b8b1bfecca6726390ccab821417f23b0876",
"fee": 4956,
"vsize": 204,
"value": 159721,
"rate": 9,
"time": 1734876204,
"rbf": true,
"fullRbf": false
},
"time": 1734876204,
"fullRbf": false,
"replaces": [
{
"tx": {
"txid": "9624fe4f9a183dcea2e8c6b640394eecaec37363aec883a64358f6953fba3145",
"fee": 1632,
"vsize": 204,
"value": 163045,
"rate": 8,
"time": 1734876081,
"rbf": true
},
"time": 1734876081,
"interval": 123,
"fullRbf": false,
"replaces": []
}
],
"interval": 372
}
]
},
...
]
}Track Mempool Full RBF Transactions mempool
Description
Subscribe to new Full RBF events.
Payload
{ "track-rbf": "fullRbf" }Response
{
"rbfLatest": [
{
"tx": {
"txid": "ed9e1ec0e1635d465ee95c8872efff367d420fc2c4e624bada2c6e6e6c8e0629",
"fee": 4123,
"vsize": 587.75,
"value": 25545,
"rate": 7.014887282007656,
"time": 1734876941,
"rbf": false,
"fullRbf": true
},
"time": 1734876941,
"fullRbf": true,
"replaces": [
{
"tx": {
"txid": "495ad5d39d44286e99bc45d104605407325cd4790f842dc3287fbfdda8ee5795",
"fee": 1178,
"vsize": 587.25,
"value": 28490,
"rate": 2.0059599829714774,
"time": 1734853572,
"rbf": false,
"fullRbf": true
},
"time": 1734853572,
"fullRbf": true,
"replaces": [
{
"tx": {
"txid": "189751a7560a6c39deb9a93db2a27374842c646268d0007ba52aefa189833afa",
"fee": 589,
"vsize": 587.25,
"value": 29079,
"rate": 1.0029799914857387,
"time": 1734781955,
"rbf": false
},
"time": 1734781955,
"interval": 71617,
"fullRbf": true,
"replaces": []
}
],
"interval": 23369
}
]
},
...
]
}