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.

Arguments

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.

Response

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	A standard SyncStatus object. Provides the information that helps to track the progress of transaction history preloading at background

Request (BCH from page 2)

POST

my_tx_history

{
  "userpass": "testpsw",
  "method": "my_tx_history",
  "mmrpc": "2.0",
  "params": {
    "coin": "BCH",
    "limit": 2,
    "paging_options": {
      "PageNumber": 2
    }
  }
}

Request (TTT-SLP with FromId)

POST

my_tx_history

{
  "userpass": "testpsw",
  "method": "my_tx_history",
  "mmrpc": "2.0",
  "params": {
    "coin": "TTT-SLP",
    "limit": 2,
    "paging_options": {
      "FromId": "433b641bc89e1b59c22717918583c60ec98421805c8e85b064691705d9aeb970"
    }
  }
}

Request (IRIS with limit = 50)

POST

my_tx_history

{
  "userpass": "testpsw",
  "method": "my_tx_history",
  "mmrpc": "2.0",
  "params": {
    "coin": "IRIS",
    "limit": 50
  }
}

Error cases

Error - Coin not active

{
  "mmrpc": "2.0",
  "error": "TTT-SLP",
  "error_path": "my_tx_history_v2.lp_coins",
  "error_trace": "my_tx_history_v2:389] lp_coins:2847]",
  "error_type": "CoinIsNotActive",
  "error_data": "TTT-SLP",
  "id": null
}

Error - Coin not compatible

{
  "mmrpc": "2.0",
  "error": "TTT-SLP",
  "error_path": "my_tx_history_v2",
  "error_trace": "my_tx_history_v2:336]",
  "error_type": "NotSupportedFor",
  "error_data": "TTT-SLP",
  "id": null
}

Error - Coin enabled without tx_history = true

{
  "mmrpc": "2.0",
  "error": "Storage is not initialized for TTT-SLP",
  "error_path": "my_tx_history_v2",
  "error_trace": "my_tx_history_v2:343]",
  "error_type": "StorageIsNotInitialized",
  "error_data": "Storage is not initialized for TTT-SLP",
  "id": null
}

Error - Local database failed

{
  "mmrpc": "2.0",
  "error": "SqliteFailure(Error { code: Unknown, extended_code: 1 }, Some(\"no such column: block_height\"))",
  "error_path": "my_tx_history_v2.sql_tx_history_storage",
  "error_trace": "my_tx_history_v2:351] sql_tx_history_storage:472]",
  "error_type": "StorageError",
  "error_data": "SqliteFailure(Error { code: Unknown, extended_code: 1 }, Some(\"no such column: block_height\"))",
  "id": null
}