Currently, SimpleHash provides access to top bids. The top bid is the highest current offer, or bid, for any NFT within a collection.
Top bids from the following marketplaces are included: Blur
Coverage of additional marketplaces and bid types will be added in the near future.
The top bids array can be found on the field named top_bids on the collection model on the "NFT by..." endpoints, and directly on the the Collections by Wallet endpoint.
top_bids model:
| Field | Description | Type(s) |
|---|---|---|
| marketplace_id | Unique identifier of the NFT marketplace associated with the top bid | string |
| value | The value of the top bid in the relevant currency | int/null |
| payment_token | Detail on the relevant currency | payment_token |
| value_usd_cents | The value of the top bid in USD cents | int/ null |
payment_token model:
| Field | Description | Type(s) |
|---|---|---|
| payment_token_id | Unique identifier of the token type relevant to the collection. Currently for ethereum ecosystem sales, this may be ethereum.native for the native ETH token, or ethereum.{contract_address} for ERC-20 tokens | string |
| name | Name of the token, e.g., Ether derived from the contract or otherwise | string / null |
| symbol | Symbol of the token derived from the contract or otherwise, e.g., ETH | string / null |
| address | Contract address of the ERC-20 token associated with the collection (null in the case of the native ETH token) | string / null |
| decimals | Base number of decimals of the token value associated with the collection (e.g., 18 in the case of the native ETH token) | int |