Get Token by ID

Get Token By ID.

This method will use 20 Compute Units.

---

Get token by id

get

Returns token entity information given the id

Path parameters

tokenIdstring · nullableRequired

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

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

Query parameters

timestampstringOptionalExample: {"summary":"--","value":""}Pattern: ^((eq|lt|lte):)?\d{1,10}(.\d{1,9})?$

Responses

200

OK

application/json

auto_renew_accountstring · nullableOptional

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

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

auto_renew_periodinteger · int64 · nullableOptional

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

decimalsstringOptionalExample: 1000

deletedboolean · nullableOptionalExample: true

expiry_timestampinteger · int64 · nullableOptionalExample: 1234567890100000

freeze_defaultbooleanOptionalExample: false

initial_supplystringOptionalExample: 1000000

max_supplystringOptionalExample: 9223372036854775807

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

namestringOptionalExample: Token name

memostringOptionalExample: token memo

pause_statusstring · enumOptionalExample: UNPAUSEDPossible values:

supply_typestring · enumOptionalExample: INFINITEPossible values:

symbolstringOptionalExample: ORIGINALRDKSE

token_idstring · nullableOptional

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

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

total_supplystringOptionalExample: 1000000

treasury_account_idstring · nullableOptional

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

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

typestring · enumOptionalExample: FUNGIBLE_COMMONPossible values:

400

Invalid parameter

application/json

404

Not Found

application/json

get

/api/v1/tokens/{tokenId}

HTTPcURLJavaScriptPython

GET /v1/YOUR_API_KEY/api/v1/tokens/{tokenId} HTTP/1.1
Host: mainnet.hedera.validationcloud.io
Accept: */*

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