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

TOP Group (The Open Platform) NFT API

The NFT API from TOP Group (The Open Platform) — 8 operation(s) for nft.

TOP Group (The Open Platform) NFT API is one of 23 APIs that TOP Group (The Open Platform) publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include NFT. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 8 operations across 8 paths, and defines 62 schemas. It is described by OpenAPI 3.0.0, at version 2.0.0.

Requests are made against 3 base URLs: https://tonapi.io, https://testnet.tonapi.io, http://localhost:8081.

8 operations 8 paths 62 schemas 6 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
2.0.0
Base URL
https://tonapi.io
Contact
Resource Areas
1

Paths & Operations 8

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

NFT 8
GET
/v2/accounts/{account_id}/nfts/history
Get the transfer nft history
getAccountNftHistory 4 params → 200default
GET
/v2/nfts/collections
Get NFT collections
getNftCollections 2 params → 200default
GET
/v2/nfts/collections/{account_id}
Get NFT collection by collection address
getNftCollection 1 param → 200default
POST
/v2/nfts/collections/_bulk
Get NFT collection items by their addresses
getNftCollectionItemsByAddresses body → 200default
GET
/v2/nfts/collections/{account_id}/items
Get NFT items from collection by collection address
getItemsFromCollection 3 params → 200default
POST
/v2/nfts/_bulk
Get NFT items by their addresses
getNftItemsByAddresses body → 200default
GET
/v2/nfts/{account_id}
Get NFT item by its address
getNftItemByAddress 1 param → 200default
GET
/v2/nfts/{account_id}/historydeprecated
Please use getAccountNftHistory instead
getNftHistoryByID 6 params → 200default

Schemas 62

The contract defines 62 schemas that model the data the API accepts and returns. The most detailed are Action (36 properties), NftItem (14 properties), JettonSwapAction (11 properties), JettonPreview (10 properties). Each schema is shown below with its type and property counts.

PoolImplementationType
string
ContractDeployAction
object
2 properties 2 required
Price
object
7 properties 6 required
GasRelayAction
object
3 properties 3 required
WithdrawXTRAction
object
2 properties 2 required
WithdrawStakeRequestAction
object
validator's participation in elections
5 properties 3 required
JettonTransferAction
object
9 properties 4 required
JettonSwapAction
object
11 properties 5 required
SmartContractAction
object
7 properties 4 required
TonTransferAction
object
6 properties 3 required
VaultDepositInfo
object
2 properties 2 required
InsufficientFunds
object
Present on an error when a request failed because the source wallet does not hold enough TON to cover the required gas (errorcode 50000).
2 properties 2 required
SubscriptionAction
object
7 properties 6 required
NftApprovedBy
array
DomainRenewAction
object
3 properties 3 required
WithdrawStakeAction
object
validator's participation in elections
4 properties 4 required
PurchaseAction
object
5 properties 5 required
Action
object
36 properties 4 required
EncryptedComment
object
2 properties 2 required
ScaledUI
object
2 properties 2 required
DepositXTRAction
object
2 properties 2 required
JettonBurnAction
object
4 properties 4 required
NftCollections
object
1 property 1 required
Protocol
object
2 properties 1 required
Sale
object
4 properties 3 required
AddExtensionAction
object
2 properties 2 required
ExtraCurrencyTransferAction
object
6 properties 4 required
OraclePriceFeed
object
3 properties 2 required
NftItem
object
14 properties 6 required
ActionSimplePreview
object
shortly describes what this action is about.
7 properties 3 required
LiquidityDepositAction
object
3 properties 3 required
DepositStakeAction
object
validator's participation in elections
5 properties 4 required
EcPreview
object
4 properties 4 required
JettonVerificationType
string
NftItems
object
1 property 1 required
RemoveExtensionAction
object
2 properties 2 required
AuctionBidAction
object
5 properties 4 required
JettonMintAction
object
4 properties 4 required
NftCollection
object
9 properties 5 required
CurrencyType
string
TrustType
string
NftItemTransferAction
object
7 properties 1 required
AccountEvents
object
Paginated list of events for a single account.
2 properties 2 required
WithdrawTokenStakeRequestAction
object
3 properties 2 required
BuyXTRAction
object
2 properties 2 required
OracleRequestAction
object
3 properties 3 required
ElectionsRecoverStakeAction
object
2 properties 2 required
NftCollectionMetadataStatus
object
4 properties
NftOperations
object
2 properties 1 required
ElectionsDepositStakeAction
object
2 properties 2 required
JettonPreview
object
10 properties 7 required
NftOperation
object
7 properties 5 required
SetSignatureAllowedAction
object
2 properties 2 required
ImagePreview
object
2 properties 2 required
DepositTokenStakeAction
object
3 properties 2 required
Refund
object
2 properties 2 required
UnSubscriptionAction
object
4 properties 4 required
NftPurchaseAction
object
5 properties 5 required
Metadata
object
2 properties 1 required
AccountAddress
object
5 properties 3 required
AccountEvent
object
High-level view over a transaction trace caused by a single inbound message. TonAPI analyses the trace, detects known patterns and groups low-level transaction…
10 properties 9 required
FlawedJettonTransferAction
object
10 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

top-group-nft-api-openapi.yml Raw ↑

Other APIs TOP Group (The Open Platform) publishes across the network.

TOP Group (The Open Platform) Accounts API
TOP Group (The Open Platform) Blockchain API
TOP Group (The Open Platform) Connect API
TOP Group (The Open Platform) DNS API
TOP Group (The Open Platform) Emulation API
TOP Group (The Open Platform) Events API
TOP Group (The Open Platform) ExtraCurrency API
TOP Group (The Open Platform) Gasless API
TOP Group (The Open Platform) Jettons API
TOP Group (The Open Platform) Lite Server API
TOP Group (The Open Platform) Migration API
TOP Group (The Open Platform) Multisig API