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 |