History

About

History API is used to get the information about transaction history of addresses

Routes

POST /history

Returns transaction history of addresses on specified networks

Request body format

{
  "networks": {
    "network_id_1": ["address_1", "address_2"],
    "network_id_2": ["address_3", "address_4"]
  }
}

In request body networks is a record which uses network_id as a key and arrays of addresses as values. Any unsupported network ids are skipped.

Example:

{
  "networks": {
    "bch": ["qzh96ajgz9ufvs4zmrzq8jr95s7nm0qlnclvk3vpe0"],
    "litecoin": ["LW1LMwNjA6EAJm6BC87EGm6PgHgWcPDgbW"],
    "polkadot": ["14Ns6kKbCoka3MS4Hn6b7oRw9fFejG8RH5rq5j63cWUfpPDJ"]
  }
}

Response is a record where the keys are network_ids and values are records with addresses as keys and transaction lists as values.

Example:

{
  "optimism": {
    "0x290b65995dede04c163cb3668096b99505fe0759": [
      {
        "hash": "0xde82ff558f6e1a2729ef8ee670a92d70c0f47f01a290880cdfdace2c9804c310",
        ,
        "explorer": "https://optimistic.etherscan.io/tx/0xde82ff558f6e1a2729ef8ee670a92d70c0f47f01a290880cdfdace2c9804c310",
        "type": "Receive",
        "fee": null,
        "status": "Success",
        "timestamp": 1736929281,
        "from": [
          {
            "address": "0xdede653ab8dc037a8f977c76f66d64eb5d5dccd6",
            "amount": "5488590741441294",
            "currency": {
              "price": 1.15,
              "img": "https://coin-images.coingecko.com/coins/images/11683/large/Balancer.png?1696511572",
              "coinId": "balancer",
              "decimals": 18,
              "symbol": "bal"
            }
          }
        ],
        "to": [
          {
            "address": "0x290b65995dede04c163cb3668096b99505fe0759",
            "amount": "5488590741441294",
            "currency": {
              "price": 1.15,
              "img": "https://coin-images.coingecko.com/coins/images/11683/large/Balancer.png?1696511572",
              "coinId": "balancer",
              "decimals": 18,
              "symbol": "bal"
            }
          }
        ]
      }
    ]
  }
}

History entry fields

Field	Type	Description
hash	string	Transaction hash
explorer	object	URL of the transaction on the explorer
type	string	Type of the transaction. It's either one of the types, defined by Extra Wallet team(Contract Call, Receive, Send, Cancel), or the type defined by the network itself(f.e. Ripple's Account Delete)
fee	string / null	Fee payed for transaction denominated in base units(satoshi for Bitcoin, wei for EVM etc.). null if fee was not found.
status	string	Status of the transaction. One of the four values: Failed, Success, Pending, Unknown.
timestamp	number	UNIX time when the transaction was executed.
from	object	Object that contains information about where the currency is taken from.
to	object	Object that contains information about where the currency is taken to.

from/to objects fields

Field	Type	Description
address	string	Address that spends/receives the currency.
amount	string	Raw(not formatted using currency decimals) amount of currency that was spent/received.
currency	(Optional) string / object	The currency that was spent/received. If the field is absent, the currency was a native token. If the field is a string it's either Unknown in case no info was found about the currency or a token symbol in case no info other info about the token was found.

currency object fields

Field	Type	Description
img	string	URL to currency image.
coinId	string	CoinGecko currency id.
decimals	number	Decimals of the currency.
price	number	USD price of the currency.
symbol	number	Token symbol.