TAtatum
Auction

Get information about an auctioned asset at the NFT auction

/v3/blockchain/auction/{chain}/{contractAddress}/{id}

1 credit per API call

Get information about a specific auctioned asset at the NFT auction.

This API is supported for the following blockchains:

  • BNB Smart Chain
  • Celo
  • Ethereum
  • Harmony
  • Polygon
get/v3/blockchain/auction/{chain}/{contractAddress}/{id}

Request

  • Base URL
    https://api.tatum.io
  • URL
    https://api.tatum.io/v3/blockchain/auction/{chain}/{contractAddress}/{id}
  • Auth
    API key in header x-api-key

Path parameters

chain'ETH' | 'ONE' | 'CELO' | 'MATIC' | 'BSC' required

Blockchain to work with

contractAddressstring required
Example:0xe6e7340394958674cdf8606936d292f565e4ecc4

Contract address

idstring required
Example:123456

Auction ID

Response

OK

amountstring

Amount of NFTs to sold in this auction. Valid only for ERC1155 listings.

bidderstring

Address of the highest buyer, if exists.

erc20Addressstring

Address of the ERC20 token smart contract, which should be used for paying for the asset..

isErc721boolean

If the listing is for ERC721 or ERC1155 token.

startedAtstring

Block height this auction started at.

endedAtstring

Block height this auction ended at.

nftAddressstring

Address of the NFT smart contract.

endingPricestring

Final auction price of the NFT asset in native currency or ERC20 token based on the presence of erc20Address field.

sellerstring

Address of the seller.

highestBidstring

Current highest bid of the NFT asset in native currency or ERC20 token based on the presence of erc20Address field.

Example response

{
  "amount": "1",
  "bidder": "0xc21C81ef03f98898Fb155E00C364e8a7b9D158b8",
  "erc20Address": "0xc21C81ef03f98898Fb155E00C364e8a7b9D158b8",
  "isErc721": true,
  "startedAt": "12345",
  "endedAt": "12349",
  "nftAddress": "0xc21C81ef03f98898Fb155E00C364e8a7b9D158b8",
  "endingPrice": "1.234",
  "seller": "0xc21C81ef03f98898Fb155E00C364e8a7b9D158b8",
  "highestBid": "1.234"
}

Changes

No recorded changes to this operation across all 1 revision of this API.