List Marketplace Listings

Fetch historical and current asset listings from different marketplaces.

List Asset Listings

GET https://api.dkoda.xyz/v1/asset/listings

Lists NFT asset listings for the given contract address, an optional asset id filter, an optional marketplace filter and an optional status filter.

Query Parameters

Name	Type	Description
contractAddress*	String	The contract address of the collection. e.g. "0x60e4d786628fea6478f785a6d7e704777c86a7c6"
assetId	String	An optional id of a specific asset to filter listings by. If not provided, the listings for all assets in the collection will be fetched. e.g. "8206"
limit	Integer	A limit on the number of sales to be returned. Limit can range between 1 and 50. The default is 20.
cursor	String	A cursor value to use to fetch the next page. If no cursor is provided, the first page will be fetched which returns the latest sales.
status	String	A value to filter statuses with. Can be one of CREATED, FULFILLED, CANCELLED, EXPIRED.
marketplace	String	A value to filter marketplaces with. Can be one of OPENSEA, X2Y2, LOOKSRARE.

Headers

Name	Type	Description
x-api-key*	String	The API key to use when making requests.

200 Success

{
  "success": 1,
  "cursor": "MTIzOTF1ODIzOTgxMnUzOTE4MnUzOTEyMw==",
  "data": [
    {
      "marketplaceId" : "7107191190",
      "marketplace" : "OPENSEA",
      "contractAddress" : "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
      "assetId" : "6480",
      "createdAt": 1656885507,
      "lastUpdatedAt": 1659563907,
      "price" : "30000000000000000000",
      "currency": "ETH",
      "status": "CREATED"
    },
    {
      "marketplaceId" : "7664491",
      "marketplace" : "X2Y2",
      "contractAddress" : "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
      "assetId" : "4614",
      "createdAt": 1658814953,
      "lastUpdatedAt": 1659563907,
      "price" : "15250000000000000000",
      "currency": "ETH",
      "status": "FULFILLED"
    },
    {
      "marketplaceId" : "0x0000eea91ec505bd829c3a74f5c65560e0018e19fd7093281b2d6fd26567ac3c",
      "marketplace" : "LOOKSRARE",
      "contractAddress" : "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
      "assetId" : "3903",
      "createdAt": 1656885507,
      "lastUpdatedAt": 1659563907,
      "price" : "30100000000000000000",
      "currency": "ETH",
      "status": "CANCELLED"
    }
  ]
}

400: Bad Request Bad Request

{
  "successful": 0,
  "errorMessage": "Invalid contract address. Please ensure the contract address is a valid Ethereum address."
}

401: Unauthorized Unauthorized

{
  "successful": 0,
  "errorMessage": "No API key is specified, please contact us at [email protected] to request an API key."
}

Good to know: This endpoint requires an API key to be present in the request header. Please contact us to request one.

Important: Certain marketplaces don't differentiate between EXPIRED and CANCELLED statuses. Some listings might have a status of CANCELLED even if they expired.