apiTON
HomeExplorerBlog
HomeExplorerBlog
Contact
  1. v2.Nft
  • api:TON Documentation
  • v2.Nft
    • Username
      POST
    • Number
      POST
    • Domain
      POST
    • Gift
      POST
    • Item
      POST
    • Items
      POST
  • v2.Rate
    • Fiat rate
      POST
    • Crypto rate
      POST
    • Exchanges rate
      POST
    • Jetton prices
      POST
  • v2.Auth
    • Do
      POST
    • List
      POST
    • Import
      POST
    • Backup
      POST
    • Delete
      POST
    • New
      POST
  • v2.Wallet
    • Send TON
      POST
    • Send Jetton
      POST
    • Send Nft
      POST
  • v2.Address
    • Transactions
      POST
    • Details
      POST
    • Jettons
      POST
    • NFTs
      POST
    • Wallets
      POST
    • Collections
      POST
    • Run get-method
      POST
    • Address labels
      POST
  • v2.NftContract
    • Mint Nft Collection
    • Mint NFT
  • v2.JettonContract
    • Mint
    • Burn
    • Change owner
    • Close Mint
  • v2.Watch
    • Create watch
    • List watches
    • Delete watch
    • Poll events
    • Test watch
  • v2.SiteProxy
    • Site proxy offer
    • Check website and domain
    • Create site proxy order
    • Get site proxy order
    • Verify site proxy order
    • Stop site proxy order
    • List site proxy orders
  • Schemas
    • Schemas
      • Connect Error
      • google.protobuf.Any
      • NftDomainSite
      • SiteProxyUsage
      • ListValue
      • Message
      • SiteProxyUsageRecent
      • NullValue
      • Struct
      • AddressGetMethod
      • FieldsEntry
      • DetailsResponse
      • AddressGetMethodArg
      • google.protobuf.Timestamp
      • DetailsRequest
      • AddressLabel
      • AddressLabelsRequest
      • google.protobuf.Value
      • AddressRunGetMethodRequest
      • AddressLabelsResponse
      • BlockID
      • AddressRunGetMethodResponse
      • BurnRequest
      • AddressStackEntry
      • BurnResponse
      • TransactionsResponse
      • ChangeAdminRequest
      • SiteProxyCheckRequest
      • ChangeAdminResponse
      • SiteProxyCheckResponse
      • CloseMintRequest
      • SiteProxyCreateRequest
      • CloseMintResponse
      • SiteProxyCreateResponse
      • DetailsAddress
      • SiteProxyGetRequest
      • DetailsRequest
      • SiteProxyGetResponse
      • DetailsResponse
      • SiteProxyListRequest
      • DomainRequest
      • SiteProxyListResponse
      • DomainResponse
      • SiteProxyOfferRequest
      • ItemRequest
      • SiteProxyOfferResponse
      • ItemResponse
      • SiteProxyOrder
      • Jetton
      • SiteProxyOwner
      • JettonDetails
      • SiteProxyPay
      • JettonsRequest
      • SiteProxyPayMessage
      • JettonsResponse
      • SiteProxyProblem
      • Message
      • SiteProxyRecord
      • MintCollectionRequest
      • SiteProxyRouteLimits
      • MintCollectionResponse
      • SiteProxyStopRequest
      • MintNftRequest
      • SiteProxyStopResponse
      • MintNftResponse
      • MintRequest
      • SiteProxyVerifyRequest
      • MintResponse
      • SiteProxyVerifyResponse
      • NftItem
      • SiteProxyWebProof
      • NftsRequest
      • NftsResponse
      • NumberRequest
      • NumberResponse
      • RateCryptoRequest
      • RateCryptoResponse
      • ResultEntry
      • RateExchangesRequest
      • RateExchangesResponse
      • ResultEntry
      • RateFiatRequest
      • RateFiatResponse
      • ResultEntry
      • SendJettonRequest
      • SendJettonResponse
      • SendNftRequest
      • SendNftResponse
      • SendRequest
      • SendResponse
      • TeleAuction
      • TeleAuctionConfig
      • TeleAuctionLastBid
      • TeleSale
      • Transaction
      • TransactionsRequest
      • TransactionsResponse
      • UsernameRequest
      • UsernameResponse
      • Version
      • WalletAuth
      • WalletAuth4
      • WalletDetails
      • WalletNewRequest
      • WalletNewResponse
      • WalletsRequest
      • WalletsResponse
      • AddressCollection
      • AddressCollectionsRequest
      • AddressCollectionsResponse
      • AuthBackupRequest
      • AuthDeleteRequest
      • AuthDeleteResponse
      • AuthDoRequest
      • AuthImportRequest
      • AuthJwtResponse
      • AuthListRequest
      • AuthListResponse
      • AuthNewRequest
      • BlockID
      • BurnRequest
      • BurnResponse
      • ChangeAdminRequest
      • ChangeAdminResponse
      • CloseMintRequest
      • CloseMintResponse
      • DetailsAddress
      • DomainRequest
      • DomainResponse
      • GiftAttribute
      • GiftRequest
      • GiftResponse
      • ItemRequest
      • ItemResponse
      • Jetton
      • JettonDetails
      • JettonsRequest
      • JettonsResponse
      • MintCollectionRequest
      • MintCollectionResponse
      • MintNftRequest
      • MintNftResponse
      • MintRequest
      • MintResponse
      • NftItem
      • NftItemsRequest
      • NftsRequest
      • NftsResponse
      • NumberRequest
      • NumberResponse
      • RateCryptoRequest
      • RateCryptoResponse
      • RateExchangesRequest
      • RateExchangesResponse
      • RateFiatRequest
      • RateFiatResponse
      • RateJettonPricesRequest
      • RateJettonPricesResponse
      • SendJettonRequest
      • SendJettonResponse
      • SendNftRequest
      • SendNftResponse
      • SendRequest
      • SendResponse
      • TeleAuction
      • TeleAuctionConfig
      • TeleAuctionLastBid
      • TeleSale
      • Transaction
      • TransactionsRequest
      • UsernameRequest
      • UsernameResponse
      • Version
      • WalletAuth
      • WalletDetails
      • WalletInfo
      • WalletsRequest
      • WalletsResponse
    • WatchCreateRequest
    • WatchCreateResponse
    • WatchDeleteRequest
    • WatchDeleteResponse
    • WatchEvent
    • WatchLimits
    • WatchListRequest
    • WatchListResponse
    • WatchPollRequest
    • WatchPollResponse
    • WatchSubscription
    • WatchTestRequest
    • WatchTestResponse
    • WatchTx
    • WatchWebhook
  1. v2.Nft

Domain

POST
/v2.Nft/Domain
.ton domain NFT: owner, expiry, sale or auction, and the domain's TON Site.
Request. domain — 4–128 characters, ending with .ton.
Response. time_expire — the domain must be renewed before it; after it anyone can start a one-week release auction. site — the domain's DNS site record (TEP-81) and apiton's last probe of it; absent when the domain has no site record:
FieldMeaning
kindadnl (RLDP-HTTP server) or storage (TON Storage bag)
addressADNL id or bag id, 64 hex
statusunknown · live · parked (parking / hosting stub) · http_error · unreachable · dht_not_found
title, latency_msof the last successful answer
uptime_30dshare (0..1) of probes over 30 days that got an answer
checked_at, live_sincelast probe; start of the current live streak
gateway_urlthe site in a regular browser: https://site.apiton.org/<name>.ton/ (live sites only)
views_30dunique daily opens through apiton's gateway over 30 days
Status and price. status is available (exists, not listed), sale (fixed price — sale object), auction (auction object) or unavailable (no such item, or taken down — HTTP 200, every other field empty). Prices are in whole TON unless sale.currency names a jetton. While the NFT sits in a sale or auction contract, owner_address is the real owner (the seller), not the contract. A contract that can no longer sell (sale complete, never initialised, auction ended without a bid) is not a listing: the item is available.
Errors (Connect JSON envelope {"code":…,"message":…})
CodeWhen
failed_precondition (412)the name does not end with .ton, or the NFT could not be read
unavailable (503)the public TON liteservers could not serve the read — retry in a second or two

Request

Body Params application/json

Example
{
    "domain": "trc20.ton"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://app.apiton.org/v2.Nft/Domain' \
--header 'Content-Type: application/json' \
--data '{
    "domain": "trc20.ton"
}'

Responses

🟢200OK
application/json
Bodyapplication/json

Examples
{
    "address": "UQB43-VCmf17O7YMd51fAvOjcMkCw46N_3JMCoegH_ZDo9Db",
    "owner_address": "UQCdqXGvONLwOr3zCNX5FjapflorB6ZsOdcdfLrjsDLt3AF4",
    "time_expire": "2025-02-25T13:36:40Z"
}
🔴500Server Error
Previous
Number
Next
Gift
Built with