Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hedera tokens API

The tokens object represents the information associated with a token entity and returns a list of token information.The tokens list endpoint is cached and not updated as frequently as the token lookup by a specific ID.

Hedera tokens API is one of 10 APIs that Hedera publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include tokens. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and rate-limit docs.

This API exposes 6 operations across 6 paths, and defines 22 schemas. It is described by OpenAPI 3.1.0, at version 0.156.0.

Requests are made against a single base URL, {scheme}://{network}.mirrornode.hedera.com.

6 operations 6 paths 22 schemas 6 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.156.0
Base URL
https://mainnet.mirrornode.hedera.com
License
Resource Areas
1

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 6 GET. Each is listed below with its method, path, parameters, and response codes.

tokens 6

The tokens object represents the information associated with a token entity and returns a list of token information.The tokens list endpoint is cached and not updated as frequentl…

GET
/api/v1/tokens
List tokens
getTokens 7 params → 200400
GET
/api/v1/tokens/{tokenId}
Get token by id
getToken 2 params → 200400404
GET
/api/v1/tokens/{tokenId}/balances
List token balances
getTokenBalances 7 params → 200400
GET
/api/v1/tokens/{tokenId}/nfts
List nfts
getNfts 5 params → 200400
GET
/api/v1/tokens/{tokenId}/nfts/{serialNumber}
Get nft info
getNft 2 params → 200400404
GET
/api/v1/tokens/{tokenId}/nfts/{serialNumber}/transactions
Get an nfts transction history
getNftTransactions 5 params → 200206400

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are TokenInfo (29 properties), Nft (9 properties), FractionalFee (7 properties), NftTransactionTransfer (7 properties). Each schema is shown below with its type and property counts.

Token
object
7 properties 6 required
Tokens
array
NftTransactionTransfer
object
7 properties 7 required
EntityIdQuery
string
Nft
object
9 properties
TokensResponse
object
2 properties
Nfts
object
2 properties
Key
objectnull
The public key which controls access to various network entities.
2 properties
FractionalFee
object
7 properties
TimestampNullable
stringnull
A Unix timestamp in seconds.nanoseconds format
TokenBalancesResponse
object
3 properties
TransactionTypes
string
NftTransactionHistory
object
2 properties 2 required
Links
object
1 property
EntityId
stringnull
Network entity ID in the format of shard.realm.num
CustomFees
object
4 properties
TokenDistribution
array
RoyaltyFee
object
4 properties
Timestamp
string
A Unix timestamp in seconds.nanoseconds format
FixedFee
object
4 properties
Error
object
1 property
TokenInfo
object
29 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hedera-tokens-api-openapi.yml Raw ↑

Other APIs Hedera publishes across the network.

Hedera accounts API
Hedera airdrops API
Hedera balances API
Hedera blocks API
Hedera contracts API
Hedera network API
Hedera schedules API
Hedera topics API
Hedera transactions API