---
title: "Get information about an auctioned asset at the NFT auction"
method: GET
path: "/v3/blockchain/auction/{chain}/{contractAddress}/{id}"
tags: ["Auction"]
---

# Get information about an auctioned asset at the NFT auction

`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`

/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

## Path parameters

- `chain` 'ETH' | 'ONE' | 'CELO' | 'MATIC' | 'BSC', required
- `contractAddress` string, required
- `id` string, required

## Response `200`

OK

- object
  - `amount` string: Amount of NFTs to sold in this auction. Valid only for ERC1155 listings.
  - `bidder` string: Address of the highest buyer, if exists.
  - `erc20Address` string: Address of the ERC20 token smart contract, which should be used for paying for the asset..
  - `isErc721` boolean: If the listing is for ERC721 or ERC1155 token.
  - `startedAt` string: Block height this auction started at.
  - `endedAt` string: Block height this auction ended at.
  - `nftAddress` string: Address of the NFT smart contract.
  - `endingPrice` string: Final auction price of the NFT asset in native currency or ERC20 token based on the presence of erc20Address field.
  - `seller` string: Address of the seller.
  - `highestBid` string: Current highest bid of the NFT asset in native currency or ERC20 token based on the presence of erc20Address field.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403`: Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/smart-contracts.md) - [All operations](https://skmtc.dev/tatum/apis/smart-contracts/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/smart-contracts/revisions/c0146043bb37?raw)