⚙️Transactions

The Transactions API returns information regarding the transactions performed by a given address. The information returned is similar to results returned from a blockchain explorer.

The first API will return the number of transactions an address have performed per chain.

Returns the number of transactions an address performed on each chain

GET https://query.nansen.ai/api/portfolio/txns/count/{address}

This is a multi-chain API call that will return the number of transactions an address have performed on each chain.

Path Parameters

Name	Type	Description
api_key*	String	The user's API key

200: OK

[
  {
    "chain": "ETHEREUM",
    "txCount": 0,
    "error": false
  },
  {
  ...}
]

This API will return transaction level details for all transactions performed by an address.

Returns transaction detail for all transactions performed by an address

GET https://query.nansen.ai/api/portfolio/txns/history/{chain}/{address}

Returns detailed information similar to a blockchain explorer.

Requires a chain and address parameter. Note that the schema returned per chain will be slightly different.

Path Parameters

Name	Type	Description
api_key*	String	The user's API key

200: OK

The schema returned will be specific to each chain.

This API takes the raw transaction level details and normalize the transactions into human readable format.

Returns human readable transaction details for an address

GET https://query.nansen.ai/api/portfolio/txns/history_readable/{chain}/{address}

Returns detailed information similar to a blockchain explorer.

Requires a chain and address parameter. Note that the schema returned per chain will be slightly different.

Path Parameters

Name	Type	Description
api_key*	String	The user's API key
isRefresh*	String	True to get the latest information. False to fetch from cache.
page*	String	Page parameter to return paginated results, starting at 1

200: OK

The schema returned will be specific to each chain.

Please note for Readable Transaction History Endpoint, isRefresh and page parameters are required.

Supported Blockchains:

The following blockchains are supported for the above endpoints:

Supported Chains	Supported Chains
Ethereum	Harmony
BSC	Boba
Polygon	Cronos
Arbitrum	Aurora
Optimism	Moonbeam
Avalanche	Moonriver
Ronin	OKC
Fantom	DFK
Metis	Dogechain