1. Overview
  2. Developer Tutorials
  3. Autheo REST API
  4. Token Methods

Token Methods

This document outlines Autheo methods pertaining to tokens.

/tokens

Returns a list of all tokens that match a given string query or of a certain type (ERC-20/721/1155)

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/tokens?q=USDT&type=ERC-20%2CERC-721%2CERC-1155' \
  -H 'accept: application/json'

Response

{
  "items": [
    {
      "circulating_market_cap": "83606435600.3635",
      "icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
      "name": "Tether USD",
      "decimals": "6",
      "symbol": "USDT",
      "address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
      "type": "ERC-20",
      "holders": "837494234523",
      "exchange_rate": "0.99",
      "total_supply": "10000000"
    }
  ],
  "next_page_params": {
    "contract_address_hash": "0x68749665ff8d2d112fa859aa293f07a622782f38",
    "holder_count": 1011,
    "is_name_null": false,
    "items_count": 50,
    "market_cap": "482534473.2170469",
    "name": "Tether Gold"
  }
}

/tokens/{address_hash}

Returns info on all tokens held by the given address hash.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997' \
  -H 'accept: application/json'

Response

{
  "circulating_market_cap": "83606435600.3635",
  "icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
  "name": "Tether USD",
  "decimals": "6",
  "symbol": "USDT",
  "address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
  "type": "ERC-20",
  "holders": "837494234523",
  "exchange_rate": "0.99",
  "total_supply": "10000000"
}

/tokens/{address_hash}/transfers

Returns all token transfers performed by the given address hash.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/transfers' \
  -H 'accept: application/json'

Response

{
  "items": [
    {
      "block_hash": "0xf569ec751152b2f814001fc730f7797aa155e4bc3ba9cb6ba24bc2c8c9468c1a",
      "from": {
        "hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
        "implementation_name": "implementationName",
        "name": "contractName",
        "is_contract": true,
        "private_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "watchlist_names": [
          {
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "public_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "is_verified": true
      },
      "log_index": "243",
      "method": "transfer",
      "timestamp": "2023-07-03T20:09:59.000000Z",
      "to": {
        "hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
        "implementation_name": "implementationName",
        "name": "contractName",
        "is_contract": true,
        "private_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "watchlist_names": [
          {
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "public_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "is_verified": true
      },
      "token": {
        "circulating_market_cap": "83606435600.3635",
        "icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
        "name": "Tether USD",
        "decimals": "6",
        "symbol": "USDT",
        "address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
        "type": "ERC-20",
        "holders": "837494234523",
        "exchange_rate": "0.99",
        "total_supply": "10000000"
      },
      "total": {
        "decimals": "18",
        "value": "1000"
      },
      "tx_hash": "0x6662ad1ad2ea899e9e27832dc202fd2ef915a5d2816c1142e6933cff93f7c592",
      "type": "token_transfer"
    }
  ],
  "next_page_params": {
    "block_number": 27736955,
    "index": 61
  }
}

/tokens/{address_hash}/holders

Returns all token holders for the given address.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/holders' \
  -H 'accept: application/json'

Response

{
  "items": [
    {
      "address": {
        "hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
        "implementation_name": "implementationName",
        "name": "contractName",
        "is_contract": true,
        "private_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "watchlist_names": [
          {
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "public_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "is_verified": true
      },
      "value": "10000",
      "token_id": "10000",
      "token": {
        "circulating_market_cap": "83606435600.3635",
        "icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
        "name": "Tether USD",
        "decimals": "6",
        "symbol": "USDT",
        "address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
        "type": "ERC-20",
        "holders": "837494234523",
        "exchange_rate": "0.99",
        "total_supply": "10000000"
      }
    }
  ],
  "next_page_params": {
    "items_count": 2,
    "value": 790000000000000000000
  }
}

/tokens/{address_hash}/counters

Returns a counter for token holders and transfers for the given address hash.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/counters' \
  -H 'accept: application/json'

Response

{
  "token_holders_count": "100",
  "transfers_count": "1000"
}

/tokens/{address_hash}/instances

Returns all non-fungible token (NFT) instances for the given address hash.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/instances' \
  -H 'accept: application/json'

Response

{
  "items": [
    {
      "is_unique": true,
      "id": "431",
      "holder_address_hash": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
      "image_url": "example.com/picture.png",
      "animation_url": "example.com/video.mp4",
      "external_app_url": "d-app.com",
      "metadata": {
        "year": 2023,
        "tags": [
          "poap",
          "event"
        ],
        "name": "Social Listening Committee #2 Attendees",
        "image_url": "https://assets.poap.xyz/chanel-poap-4c-2023-logo-1675083420470.png",
        "home_url": "https://app.poap.xyz/token/6292128",
        "external_url": "https://api.poap.tech/metadata/99010/6292128",
        "description": "This is the POAP for attendees of the second Social Listening Committee.",
        "attributes": [
          {
            "value": "01-Feb-2023",
            "trait_type": "startDate"
          },
          {
            "value": "01-Feb-2023",
            "trait_type": "endDate"
          },
          {
            "value": "false",
            "trait_type": "virtualEvent"
          },
          {
            "value": "Paris",
            "trait_type": "city"
          },
          {
            "value": "France",
            "trait_type": "country"
          },
          {
            "value": "https://www.chanel.com",
            "trait_type": "eventURL"
          }
        ]
      },
      "owner": {
        "hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
        "implementation_name": "implementationName",
        "name": "contractName",
        "is_contract": true,
        "private_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "watchlist_names": [
          {
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "public_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "is_verified": true
      },
      "token": {
        "circulating_market_cap": "83606435600.3635",
        "icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
        "name": "Tether USD",
        "decimals": "6",
        "symbol": "USDT",
        "address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
        "type": "ERC-20",
        "holders": "837494234523",
        "exchange_rate": "0.99",
        "total_supply": "10000000"
      }
    }
  ],
  "next_page_params": {
    "unique_token": 97464
  }
}

/tokens/{address_hash}/instances/{id}

Returns an NFT instance by id from a the given address hash.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/instances/431' \
  -H 'accept: application/json'

Response

{
  "is_unique": true,
  "id": "431",
  "holder_address_hash": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
  "image_url": "example.com/picture.png",
  "animation_url": "example.com/video.mp4",
  "external_app_url": "d-app.com",
  "metadata": {
    "year": 2023,
    "tags": [
      "poap",
      "event"
    ],
    "name": "Social Listening Committee #2 Attendees",
    "image_url": "https://assets.poap.xyz/chanel-poap-4c-2023-logo-1675083420470.png",
    "home_url": "https://app.poap.xyz/token/6292128",
    "external_url": "https://api.poap.tech/metadata/99010/6292128",
    "description": "This is the POAP for attendees of the second Social Listening Committee.",
    "attributes": [
      {
        "value": "01-Feb-2023",
        "trait_type": "startDate"
      },
      {
        "value": "01-Feb-2023",
        "trait_type": "endDate"
      },
      {
        "value": "false",
        "trait_type": "virtualEvent"
      },
      {
        "value": "Paris",
        "trait_type": "city"
      },
      {
        "value": "France",
        "trait_type": "country"
      },
      {
        "value": "https://www.chanel.com",
        "trait_type": "eventURL"
      }
    ]
  },
  "owner": {
    "hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
    "implementation_name": "implementationName",
    "name": "contractName",
    "is_contract": true,
    "private_tags": [
      {
        "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
        "display_name": "name to show",
        "label": "label"
      }
    ],
    "watchlist_names": [
      {
        "display_name": "name to show",
        "label": "label"
      }
    ],
    "public_tags": [
      {
        "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
        "display_name": "name to show",
        "label": "label"
      }
    ],
    "is_verified": true
  },
  "token": {
    "circulating_market_cap": "83606435600.3635",
    "icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
    "name": "Tether USD",
    "decimals": "6",
    "symbol": "USDT",
    "address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
    "type": "ERC-20",
    "holders": "837494234523",
    "exchange_rate": "0.99",
    "total_supply": "10000000"
  }
}

/tokens/{address_hash}/instances/{id}/transfers

Returns transfers of the specified NFT instance for the given address hash.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/instances/431/transfers' \
  -H 'accept: application/json'

Response

{
  "items": [
    {
      "block_hash": "0xf569ec751152b2f814001fc730f7797aa155e4bc3ba9cb6ba24bc2c8c9468c1a",
      "from": {
        "hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
        "implementation_name": "implementationName",
        "name": "contractName",
        "is_contract": true,
        "private_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "watchlist_names": [
          {
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "public_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "is_verified": true
      },
      "log_index": "243",
      "method": "transfer",
      "timestamp": "2023-07-03T20:09:59.000000Z",
      "to": {
        "hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
        "implementation_name": "implementationName",
        "name": "contractName",
        "is_contract": true,
        "private_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "watchlist_names": [
          {
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "public_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "is_verified": true
      },
      "token": {
        "circulating_market_cap": "83606435600.3635",
        "icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
        "name": "Tether USD",
        "decimals": "6",
        "symbol": "USDT",
        "address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
        "type": "ERC-20",
        "holders": "837494234523",
        "exchange_rate": "0.99",
        "total_supply": "10000000"
      },
      "total": {
        "decimals": "18",
        "value": "1000"
      },
      "tx_hash": "0x6662ad1ad2ea899e9e27832dc202fd2ef915a5d2816c1142e6933cff93f7c592",
      "type": "token_transfer"
    }
  ],
  "next_page_params": {
    "block_number": 27736955,
    "index": 61,
    "token_id": 50
  }
}

/tokens/{address_hash}/instances/{id}/holders

Returns token holders for a specific NFT instance and address hash.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/instances/431/holders' \
  -H 'accept: application/json'

Response

{
  "items": [
    {
      "address": {
        "hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
        "implementation_name": "implementationName",
        "name": "contractName",
        "is_contract": true,
        "private_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "watchlist_names": [
          {
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "public_tags": [
          {
            "address_hash": "0xEb533ee5687044E622C69c58B1B12329F56eD9ad",
            "display_name": "name to show",
            "label": "label"
          }
        ],
        "is_verified": true
      },
      "value": "10000",
      "token_id": "10000",
      "token": {
        "circulating_market_cap": "83606435600.3635",
        "icon_url": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
        "name": "Tether USD",
        "decimals": "6",
        "symbol": "USDT",
        "address": "0x394c399dbA25B99Ab7708EdB505d755B3aa29997",
        "type": "ERC-20",
        "holders": "837494234523",
        "exchange_rate": "0.99",
        "total_supply": "10000000"
      }
    }
  ],
  "next_page_params": {
    "value": 790000000000000000000,
    "token_id": "953848",
    "items_count": 50
  }
}

/tokens/{address_hash}/instances/{id}/transfers-count

Returns a transfer counter for the specific NFT instance and address hash.

Request

curl -X 'GET' \
  'https://devnet-explorer.autheo.com/api/v2/tokens/0x394c399dbA25B99Ab7708EdB505d755B3aa29997/instances/431/transfers-count' \
  -H 'accept: application/json'

Response

{
  "transfers_count": 10
}

Related Articles

Was this article helpful?
©AUTHEO LLC 2025