The SimpleHash API includes details of active listings on NFT marketplaces.
- OpenSea: Live
- LooksRare: Live
- X2Y2: Live
Coverage of more marketplaces will be added in the near future.
listing model:
| Field | Description | Type(s) |
|---|---|---|
| id | Unique identifier of the listing | string |
| permalink | Link to the marketplace listing | string |
| bundle_item_number | If the listing is part of a bundle, the NFT's position in the bundle | int / null |
| listing_timestamp | Datetime of the listing | string |
| expiration_timestamp | Expiration datetime of the listing | string |
| seller_address | Owner wallet address | string |
| auction_type | Auction type, if applicable. Possible values are: dutch(AKA decreasing price auction) | string / null |
| quantity | Original listing quantity | int |
| quantity_remaining | Remaining listing quantity | int |
| price | Total price of the listing | int |
| marketplace_id | Unique identifier of the NFT marketplace associated with the listing | 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 listing | payment_token / 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 |