my_tx_history
To use this method, you must activate your coin with "tx_history": true. The response will vary depending on the coin.
For ZHTLC coins, you must use the z_coin_tx_history method.
For all other coins, use the legacy my_tx_history method.
| Parameter* = required | Type | Description |
|---|---|---|
| coin* | string | Ticker of the coin to get history for. |
| limit | integer | Optional. Limits the number of returned transactions. Ignored if max=true. |
| paging_options | object | Optional. A standard Pagination object. |
| target | object | Optional. A standard HistoryTarget object (e.g., account_id or address_id). |
| Parameter* = required | Type | Description |
|---|---|---|
| current_block* | number | Latest block number. |
| from_id* | string|null | FromId echoed back (if any). |
| limit* | number | Requested limit. |
| page_number* | number|null | Requested page number (if any). |
| skipped* | number | Number of skipped records. |
| sync_status* | object | Standard SyncStatus object. |
| total* | number | Total number of transactions available. |
| total_pages* | number | Total pages with the chosen limit. |
| transactions* | array of objects | Transactions affecting the target. |
For SIA protocol coins, use the legacy my_tx_history method. The v2 my_tx_history method is not yet compatible.
POST
my_tx_history{
"method": "my_tx_history",
"mmrpc": "2.0",
"params": {
"coin": "DOC",
"limit": 10,
"paging_options": {
"PageNumber": 1
},
"target": {
"account_id": 77,
"type": "account_id"
}
},
"userpass": "RPC_UserP@SSW0RD"
}
Response (Success)
SUCCESS
{
"id": null,
"mmrpc": "2.0",
"result": {
"coin": "DOC",
"current_block": 2066531,
"limit": 10,
"paging_options": {
"PageNumber": 1
},
"skipped": 0,
"sync_status": {
"state": "Finished"
},
"target": {
"account_id": 77,
"type": "account_id"
},
"total": 1,
"total_pages": 1,
"transactions": [
{
"block_height": 2051968,
"coin": "DOC",
"confirmations": 14564,
"fee_details": {
"amount": "0.0001",
"coin": "DOC",
"type": "Utxo"
},
"from": [
"RNTv4xTLLm26p3SvsQCBy9qNK7s1RgGYSB"
],
"internal_id": "e5cd671c71f9a2564cd05057ee94be86bd215df257bfb7408b9ee6deb1e461c5",
"memo": null,
"my_balance_change": "7.777",
"received_by_me": "7.777",
"spent_by_me": "0",
"timestamp": 1693906841,
"to": [
"RLNu8gszQ8ENUrY3VSyBS2714CNVwn1f7P",
"RNTv4xTLLm26p3SvsQCBy9qNK7s1RgGYSB"
],
"total_amount": "24734.9033",
"transaction_type": "StandardTransfer",
"tx_hash": "e5cd671c71f9a2564cd05057ee94be86bd215df257bfb7408b9ee6deb1e461c5",
"tx_hex": "0400008085202f890165d40f00c0b4395ccdbe6d4f3124fa8b06d4910e5327b67c8186dd4b55afa124030000006b483045022100a3fe466d53ce9e5429608427e0d0224e8923d86dabf5b6c4b4d54dae7c060acd022039d165e1e245efd93a9172ab0a7837985310b4beccd6e05be1894cd66e0912cc012102d09f2cb1693be9c0ea73bb48d45ce61805edd1c43590681b02f877206078a5b3ffffffff0400e1f505000000001976a91479bdbbf2302fa86c7c5861ddc782e6e5776a546d88ac00c2eb0b000000001976a91479bdbbf2302fa86c7c5861ddc782e6e5776a546d88aca01f791c000000001976a91479bdbbf2302fa86c7c5861ddc782e6e5776a546d88ace04728b93f0200001976a91490a0d8ba62c339ade97a14e81b6f531de03fdbb288ac00000000000000000000000000000000000000"
}
]
}
}
POST
my_tx_history{
"method": "my_tx_history",
"mmrpc": "2.0",
"params": {
"coin": "DOC",
"limit": 1,
"paging_options": {
"PageNumber": 1
},
"target": {
"account_id": 0,
"address_id": 1,
"chain": "External",
"type": "address_id"
}
},
"userpass": "RPC_UserP@SSW0RD"
}
Response (Success)
SUCCESS
{
"id": null,
"mmrpc": "2.0",
"result": {
"coin": "DOC",
"current_block": 2066531,
"limit": 1,
"paging_options": {
"PageNumber": 1
},
"skipped": 0,
"sync_status": {
"state": "Finished"
},
"target": {
"account_id": 0,
"address_id": 1,
"chain": "External",
"type": "address_id"
},
"total": 10,
"total_pages": 10,
"transactions": [
{
"block_height": 2046628,
"coin": "DOC",
"confirmations": 19904,
"fee_details": {
"amount": "0.00001",
"coin": "DOC",
"type": "Utxo"
},
"from": [
"RVyndZp3ZrhGKSwHryyM3Kcz9aq2EJrW1z"
],
"internal_id": "8c6456383d7d112ec400597739e07a3c50557a4ec399b8993312d8c4780ce973",
"memo": null,
"my_balance_change": "-0.00001",
"received_by_me": "0.99292",
"spent_by_me": "0.99293",
"timestamp": 1693584717,
"to": [
"RVyndZp3ZrhGKSwHryyM3Kcz9aq2EJrW1z",
"RXNtAyDSsY3DS3VxTpJegzoHU9bUX54j56"
],
"total_amount": "0.99293",
"transaction_type": "StandardTransfer",
"tx_hash": "8c6456383d7d112ec400597739e07a3c50557a4ec399b8993312d8c4780ce973",
"tx_hex": "0400008085202f8901c97b980d21538685a1fa82e1bb0c3a25b2dfaeaecb10647403b48afaefdcef3d010000006b483045022100d4ec136c54cda3861916e2390f0c8afc5348ce7844eaecb98da1bd2c964703280220107bb95194bdb51b9fd584d1834357376288b1ed5185a2bae34b290947683f5a01210325f62245ee44b9e586e71ef462833d8aa32ae2a05d06a9b78a9fb95b7a7d2a3fffffffff0280969800000000001976a914f26650dc9aa4e4505978ad635cdb15491cee70e188ace07c5205000000001976a914e30fff4883a28b09889f3e94c24392c899d2833e88ac930cf264000000000000000000000000000000"
}
]
}
}
POST
my_tx_history{
"method": "my_tx_history",
"mmrpc": "2.0",
"params": {
"coin": "BCH",
"limit": 2,
"paging_options": {
"PageNumber": 2
}
},
"userpass": "RPC_UserP@SSW0RD"
}
Response (Success)
SUCCESS
{
"id": null,
"mmrpc": "2.0",
"result": {
"coin": "BCH",
"current_block": 772607,
"limit": 2,
"paging_options": {
"PageNumber": 2
},
"skipped": 2,
"sync_status": {
"state": "Finished"
},
"target": {
"type": "iguana"
},
"total": 16,
"total_pages": 8,
"transactions": [
{
"block_height": 766923,
"coin": "BCH",
"confirmations": 5685,
"fee_details": {
"amount": "0.00001",
"coin": "BCH",
"type": "Utxo"
},
"from": [
"bitcoincash:ppaa62685yaucdf2a54g3rgtyc9g7yawrvvmqsfumc"
],
"internal_id": "e2167df56142bccdb8c620297f1b6ca3f7c8a955332838430d4d0f62530870f9",
"my_balance_change": "0.00170035",
"received_by_me": "0.00170035",
"spent_by_me": "0",
"timestamp": 1668615553,
"to": [
"bitcoincash:qqg6z43mlf26up06vgdjufz6hedrtry99cvk5dgcnt"
],
"total_amount": "0.00171035",
"transaction_type": "StandardTransfer",
"tx_hash": "e2167df56142bccdb8c620297f1b6ca3f7c8a955332838430d4d0f62530870f9",
"tx_hex": "0100000001b7b45d92f8f3413a0e5656258e0a51f5c7e8230c0a08cef2ebec1ddbb8f7c28200000000d747304402203ca957fdfcfbba6123d78afe28b17fd4103cc04f6ada4110eb61c2a0350c29b802204215f203d583e8bcc79bd70f33af4f4e27500b5a5375efe75a1c31ec112f3c344120b3f71dbea00eeace7f09b0911de31e46f76a48036b86ccc207dac55540912e01004c6b6304dbf67563b175210315d9c51c657ab1be4ae9d3ab6e76a619d3bccfe830d5363fa168424c0d044732ac6782012088a914dde61fe24ea3cfa39379c475702692fa2f080900882103ed00156316c46094c0cbcf21a5ee549a1b3a50938c43096ef499ca28059edca6ac68ffffffff0133980200000000001976a91411a1563bfa55ae05fa621b2e245abe5a358c852e88acdbf67563"
}
]
}
}
POST
my_tx_history{
"method": "my_tx_history",
"mmrpc": "2.0",
"params": {
"coin": "BCH",
"limit": 2,
"paging_options": {
"FromId": "433b641bc89e1b59c22717918583c60ec98421805c8e85b064691705d9aeb970"
}
},
"userpass": "RPC_UserP@SSW0RD"
}
Response (Success)
SUCCESS
{
"id": null,
"mmrpc": "2.0",
"result": {
"coin": "BCH",
"current_block": 772612,
"limit": 10,
"paging_options": {
"FromId": "433b641bc89e1b59c22717918583c60ec98421805c8e85b064691705d9aeb970"
},
"skipped": 0,
"sync_status": {
"state": "Finished"
},
"target": {
"type": "iguana"
},
"total": 1,
"total_pages": 1,
"transactions": [
{
"block_height": 772211,
"coin": "BCH",
"confirmations": 402,
"fee_details": {
"amount": "0.00000482",
"coin": "BCH",
"type": "Utxo"
},
"from": [
"simpleledger:qpvq4u67x4fa276t8gsrday4nugzgm5ccu4usawss8"
],
"internal_id": "57b78eb912a704921640a589d8bb42bb147dfb88c3d1b4b2e3df910be6b9ab31",
"my_balance_change": "100",
"received_by_me": "100",
"spent_by_me": "0",
"timestamp": 1671817336,
"to": [
"simpleledger:qpvq4u67x4fa276t8gsrday4nugzgm5ccu4usawss8",
"simpleledger:qrf5vpn78s7rjexrjhlwyzzeg7gw98k7t5va3wuz4v"
],
"total_amount": "1480551016.67",
"transaction_type": {
"TokenTransfer": "5321508197ffed321c5fc9a1427e5c68b31d2c1ec92ae1c495f8acb08d8d66cd"
},
"tx_hash": "7b58248f3486079951a57d6dbd41c019a83f2b876c9fa3afa6fcc5a7c595b837",
"tx_hex": "0200000002365a29eb638da7fc57720ad6c99fdbc6cfb9c957920cfb62fd69e494b412c1c1020000006b483045022100de81bca8cfef2f95b3da8aa89edf4f5cc6cf489c565d0965b8142380ef3986f1022062d6ed47f2cd281f4860a27e835949aafbab89eeb0865fbf2280a283dfb7c417412102b9fdfedefde71b21523974b9f24a4b6a1b83c5640b839baa6eb14418cae08191ffffffffc1f73b403f893f93d95b8c7dfa1b59bb5445109d4c51107da1e08fb770e54136010000006a47304402203658375dac3b84ae17e72cf3f5157b8ad25e7caee0629fa8708868974f8d58b402206f38d016ed4e390d783627441685692d21b889d83919abd39368cba28f43f544412102b9fdfedefde71b21523974b9f24a4b6a1b83c5640b839baa6eb14418cae08191ffffffff040000000000000000406a04534c500001010453454e44205321508197ffed321c5fc9a1427e5c68b31d2c1ec92ae1c495f8acb08d8d66cd080000000000002710080000002278c569d322020000000000001976a914d346067e3c3c3964c395fee208594790e29ede5d88ac22020000000000001976a914580af35e3553d57b4b3a2036f4959f10246e98c788ac68955e03000000001976a914580af35e3553d57b4b3a2036f4959f10246e98c788ac00000000"
}
]
}
}
POST
my_tx_history{
"method": "my_tx_history",
"mmrpc": "2.0",
"params": {
"coin": "IRIS",
"limit": 50
},
"userpass": "RPC_UserP@SSW0RD"
}
Response (Success)
SUCCESS
{
"id": null,
"mmrpc": "2.0",
"result": {
"coin": "IRIS",
"current_block": 18120346,
"limit": 50,
"paging_options": {
"PageNumber": 1
},
"skipped": 0,
"sync_status": {
"state": "NotStarted"
},
"target": {
"type": "iguana"
},
"total": 3,
"total_pages": 1,
"transactions": [
{
"block_height": 18120218,
"coin": "IRIS",
"confirmations": 129,
"fee_details": {
"amount": "0.044559",
"coin": "IRIS",
"gas_limit": 100000,
"type": "Tendermint"
},
"from": [
"iaa16drqvl3u8sukfsu4lm3qsk28jr3fahja9vsv6k"
],
"internal_id": "4644373032304131304637363034374441354438413433420000000000000000",
"memo": "while you are out, buy milk",
"my_balance_change": "-0.044559",
"received_by_me": "10",
"spent_by_me": "10.044559",
"timestamp": 1673016440,
"to": [
"iaa16drqvl3u8sukfsu4lm3qsk28jr3fahja9vsv6k"
],
"total_amount": "10.044559",
"transaction_type": "StandardTransfer",
"tx_hash": "B34A8D5AD74067F01A0207DF1851A14673C859D8A6F4FB0CBE292D2104C143CA",
"tx_hex": "0a2a6961613136647271766c33753873756b667375346c6d3371736b32386a72336661686a6139767376366b122a6961613136647271766c33753873756b667375346c6d3371736b32386a72336661686a6139767376366b1a110a05756972697312083130303030303030"
}
]
}
}
Error: SIA unsupported
POST
my_tx_history{
"method": "my_tx_history",
"mmrpc": "2.0",
"params": {
"coin": "SC",
"limit": 50
},
"userpass": "RPC_UserP@SSW0RD"
}
Response (SIA unsupported)
ERROR
{
"error": "SC",
"error_data": "SC",
"error_path": "my_tx_history_v2",
"error_trace": "my_tx_history_v2:385]",
"error_type": "NotSupportedFor",
"id": null,
"mmrpc": "2.0"
}