my_tx_history
To use this method, you must activate your coin with "tx_history": true. The response will vary depending on the coin.
Currently only BCH & SLP tokens are supported in the master/release API. In the latest dev API, UTXO coins, QTUM, and Tendermint/Tendermint tokens are also supported.
For ZHTLC coins, you must use the z_coin_tx_history method.
For all other coins, use the legacy my_tx_history method.
| parameter | Type | Description |
|---|---|---|
| coin | string | Ticker of the coin to get history for. |
| limit | integer | Optional. Limits the number of returned transactions. Defaults to 10. Ignored if max = true. |
| paging_options | object | Optional. A standard Pagination object. |
| target | object | Optional. A standard HistoryTarget object. |
| Structure | Type | Description |
|---|---|---|
| transactions | array of objects | transactions data |
| from_id | string | the from_id specified in the request; this value is null if from_id was not set |
| skipped | number | the number of skipped records (i.e. the position of from_id in the list + 1); this value is 0 if from_id was not set |
| limit | number | the limit that was set in the request; note that the actual number of transactions can differ from the specified limit (e.g. on the last page) |
| total | number | the total number of transactions available |
| page_number | number | the page_number that was set in the request |
| total_pages | number | total pages available with the selected limit |
| current_block | number | the number of the latest block of coin blockchain |
| sync_status | object | provides the information that helps to track the progress of transaction history preloading at background |
| sync_status.state | string | current state of sync; possible values: NotEnabled, NotStarted, InProgress, Error, Finished |
| sync_status.additional_info | object | additional info that helps to track the progress; present for InProgress and Error states only |
| sync_status.additional_info.blocks_left | number | present for ETH/ERC20 coins only; displays the number of blocks left to be processed for InProgress state |
| sync_status.additional_info.transactions_left | number | present for UTXO coins only; displays the number of transactions left to be processed for InProgress state |
| sync_status.additional_info.code | number | displays the error code for Error state |
| sync_status.additional_info.message | number | displays the error message for Error state |
POST
my_tx_history{
"userpass": "testpsw",
"mmrpc": "2.0",
"method": "my_tx_history",
"params": {
"coin": "DOC",
"limit": 10,
"paging_options": {
"PageNumber": 1
},
"target": {
"type": "account_id",
"account_id": 77
}
}
}
POST
my_tx_history{
"userpass": "testpsw",
"mmrpc": "2.0",
"method": "my_tx_history",
"params": {
"coin": "DOC",
"limit": 1,
"paging_options": {
"PageNumber": 1
},
"target": {
"type": "address_id",
"account_id": 0,
"chain": "External",
"address_id": 1
}
}
}
POST
my_tx_history{
"userpass": "testpsw",
"method": "my_tx_history",
"mmrpc": "2.0",
"params": {
"coin": "BCH",
"limit": 2,
"paging_options": {
"PageNumber": 2
}
}
}
POST
my_tx_history{
"userpass": "testpsw",
"method": "my_tx_history",
"mmrpc": "2.0",
"params": {
"coin": "TTT-SLP",
"limit": 2,
"paging_options": {
"FromId": "433b641bc89e1b59c22717918583c60ec98421805c8e85b064691705d9aeb970"
}
}
}
POST
my_tx_history{
"userpass": "testpsw",
"method": "my_tx_history",
"mmrpc": "2.0",
"params": {
"coin": "IRIS",
"limit": 50
}
}