Get a paginated list of tokens, optionally filter by type.

GET 
/:network/tokens

Get a paginated list of tokens, optionally filter by type.

Request

Path Parameters

network stringrequired

Blockchain network name or chain id

Query Parameters

token_type string

Possible values: [erc20, erc721, erc777, erc1155]

Filter by token type (erc20, erc721, erc777, erc1155)

page number

Page number for pagination

limit number

Number of tokens per page, Max 100 per page

projectId stringrequired

The id of your project. Can be found in your Histori dashboard.

Responses

200

The paginated list of tokens.

application/json

Schema

Schema

network_name stringrequired

Blockchain network name For the requested query

chain_id numberrequired

The chain ID of the network.

page numberrequired

The current page number

limit numberrequired

The number of tokens returned per page

total_results numberrequired

The total number of Tokens.

total_pages numberrequired

The total number of pages for the requested range

next string

Link to the next page of tokens

previous string

Link to the previous page of tokens

tokens

object[]

required

The list of tokens for the current page

Array [

token_address stringrequired

Token contract address in hexadecimal format

block_height number

Block number at the time of token creation

token_type stringrequired

Type of the token (e.g., ERC20, ERC721, ERC777, ERC1155)

name stringrequired

Token name (required for all token types)

symbol stringrequired

Token symbol (required for all token types)

decimals numberrequired

Number of decimals for ERC20 tokens

granularity stringnullablerequired

Granularity for ERC777 tokens

]

Example (from schema)

{
  "network_name": "eth-mainnet",
  "chain_id": 1,
  "page": 1,
  "limit": 10,
  "total_results": 100,
  "total_pages": 10,
  "next": "https://api.histori.xyz/v1/eth-mainnet/tokens?page=2&limit=10",
  "previous": "https://api.histori.xyz/v1/eth-mainnet/tokens?page=1&limit=10",
  "tokens": [
    {
      "token_address": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "block_height": 123456,
      "token_type": "ERC20",
      "name": "My Token",
      "symbol": "MTK",
      "decimals": 18,
      "granularity": "1"
    }
  ]
}

400

Invalid request parameters.

Loading...