Currently, SimpleHash provides access to bids and top bids. The top bid is the highest current offer, or bid, for any NFT within a collection.
The SimpleHash API includes details of active bids on the following NFT marketplaces.
- OpenSea
- Magic Eden
Bid model
| Field | Description | Type(s) |
|---|---|---|
| id | Unique identifier of the bid | string |
| quantity | Bid quantity | int/null |
| price | Bid price | int |
| timestamp | Datetime of the bid | string |
| bidder_address | Bidder address | string |
| marketplace_id | Unique identifier of the NFT marketplace associated with the bid | string |
| collection_id | Unique identifier for a specific collection | string / null |
| nft_id | Unique identifier for an NFT (chain.contract_address.token_id for EVM chains & Flow, chain.mint_address for Solana) | string |
| payment_token | Detail on the token used for the bid | payment_token / null |
| expiration_timestamp | Expiration timestamp of the bid | string / null |
The SimpleHash API includes top (collection-level) bids from the following marketplaces:
- Blur
- OpenSea
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 |