Get Token by ID

Get Token By ID.

This method will use 15 Compute Units.

---

Get token by id

Returns token entity information given the id

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/tokens/{tokenId}

Path parameters

tokenId*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

Query parameters

Response

200400404

OK

Body

application/json

admin_keynullable Key (object)

auto_renew_accountnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

auto_renew_periodnullable integer (int64)

created_timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

decimalsstring

Example: 1000

deletednullable boolean

Example: true

expiry_timestampnullable integer (int64)

Example: 1234567890100000

fee_schedule_keynullable Key (object)

freeze_defaultboolean

Example: false

freeze_keynullable Key (object)

initial_supplystring

Example: "1000000"

kyc_keynullable Key (object)

max_supplystring

Example: "9223372036854775807"

modified_timestampTimestamp (string)

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

namestring

Example: "Token name"

memostring

Example: "token memo"

pause_keynullable Key (object)

pause_statusenum

Example: "UNPAUSED"

NOT_APPLICABLEPAUSEDUNPAUSED

supply_keynullable Key (object)

supply_typeenum

Example: "INFINITE"

FINITEINFINITE

symbolstring

Example: "ORIGINALRDKSE"

token_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

total_supplystring

Example: "1000000"

treasury_account_idnullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.1.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

typeenum

Example: "FUNGIBLE_COMMON"

FUNGIBLE_COMMONNON_FUNGIBLE_UNIQUE

wipe_keynullable Key (object)

custom_feesCustomFees (object)

Request

JavaScriptCurlPython

const response = await fetch('https://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/tokens/{tokenId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400404

{
  "admin_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "auto_renew_account": "0.1.2",
  "auto_renew_period": null,
  "created_timestamp": "1586567700.453054000",
  "decimals": 1000,
  "deleted": true,
  "expiry_timestamp": 1234567890100000,
  "fee_schedule_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "freeze_default": false,
  "freeze_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "initial_supply": "1000000",
  "kyc_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "max_supply": "9223372036854775807",
  "modified_timestamp": "1586567700.453054000",
  "name": "Token name",
  "memo": "token memo",
  "pause_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "pause_status": "UNPAUSED",
  "supply_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "supply_type": "INFINITE",
  "symbol": "ORIGINALRDKSE",
  "token_id": "0.1.2",
  "total_supply": "1000000",
  "treasury_account_id": "0.1.2",
  "type": "FUNGIBLE_COMMON",
  "wipe_key": {
    "_type": "ProtobufEncoded",
    "key": 10101
  },
  "custom_fees": {
    "created_timestamp": "1586567700.453054000",
    "fixed_fees": [
      {
        "all_collectors_are_exempt": false,
        "amount": 100,
        "collector_account_id": "0.1.2",
        "denominating_token_id": "0.1.2"
      }
    ],
    "fractional_fees": [
      {
        "all_collectors_are_exempt": false,
        "amount": {
          "numerator": 12,
          "denominator": 29
        },
        "collector_account_id": "0.1.2",
        "denominating_token_id": "0.1.2",
        "maximum": 120,
        "minimum": 30,
        "net_of_transfers": true
      }
    ],
    "royalty_fees": [
      {
        "all_collectors_are_exempt": false,
        "amount": {
          "numerator": 15,
          "denominator": 37
        },
        "collector_account_id": "0.1.2",
        "fallback_fee": {
          "amount": 100,
          "denominating_token_id": "0.1.2"
        }
      }
    ]
  }
}