List Asset Sales

The easiest way to fetch NFT asset sales with the most amount of data.

List Sales

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

Lists NFT sales for the given contract address and an optional asset id filter.

Query Parameters

Name	Type	Description
contractAddress*	String	The contract address of the collection. e.g. "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
assetId	String	An optional id of a specific asset to filter sales by. If not provided, the sales 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.

Headers

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

200 Success

{
  "success": 1,
  "cursor": "MTIzOTF1ODIzOTgxMnUzOTE4MnUzOTEyMw==",
  "data": [
    {
      "hash" : "0x7d25b145dbcc1ed126dd4e43fe5b0925b8af75569d94ed391fff0e2641626a83",
      "from" : "0x907854ac2768a1a923f15a1345872c149b774e4d",
      "to" : "0x28ef0ab6595f0c38fb476d125ec6175fd3eeaf6d",
      "contractAddress" : "0x23581767a106ae21c074b2276d25e5c3e136a68b",
      "assetId" : "3122",
      "timestamp" : 1658938753,
      "block" : 15226657,
      "price" : "29950000000000000000",
      "amountReceived" : "28302750000000000000",
      "currency": "ETH",
      "marketplace" : "X2Y2"
    },
    {
      "hash" : "0x0f334c62153b0c85ab168bf4eaff276d817281b3a49506d9311d1ddfc6207480",
      "from" : "0xf3741be4aa678e7828d7665be34c6b21bcaa3248",
      "to" : "0x4cdcd04e9c10b0fdda0559fde11b27f9a6e4faa1",
      "contractAddress" : "0x23581767a106ae21c074b2276d25e5c3e136a68b",
      "assetId" : "8792",
      "timestamp" : 1658937952,
      "block" : 15226596,
      "price" : "21500000000000000000",
      "amountReceived" : "19887500000000000000",
      "currency": "ETH",
      "marketplace" : "OPENSEA"
    },
    {
      "hash" : "0x498d5807f3d13d843d5a2bdd6c3d0d202751a0552179ba0195c0a5b4fd7030c9",
      "from" : "0x6033ed8095c6049ee0b5ba6e499d411f31c4fcf8",
      "to" : "0xa3b7e585430f02eeb5d3eadbc47cbeaeb482c033",
      "contractAddress" : "0x23581767a106ae21c074b2276d25e5c3e136a68b",
      "assetId" : "5996",
      "timestamp" : 1658936886,
      "block" : 15226487,
      "price" : "21000000000000000000",
      "amountReceived" : "19845000000000000000",
      "currency": "ETH",
      "marketplace" : "X2Y2"
    },
    {
      "hash" : "0x0e7f8c87b74b82e0012e7385b4d0a7407e47049ad18d523885ef414457fc6583",
      "from" : "0x3ab84b7c71c2828e4c6ff01ef5e3c675b25c9604",
      "to" : "0xdf550c82681220762a0d2d5bf6b651a6df6c6480",
      "contractAddress" : "0x23581767a106ae21c074b2276d25e5c3e136a68b",
      "assetId" : "6788",
      "timestamp" : 1658936352,
      "block" : 15226446,
      "price" : "20000000000000000000",
      "amountReceived" : "18500000000000000000",
      "currency": "ETH",
      "marketplace" : "OPENSEA"
    },
    {
      "hash" : "0x8e8ab17a61610561ff86f210544bf64455fa07bb0056479c3372ea57a8a5b447",
      "from" : "0xbf23b32f95694920c663c40416899e284aea1284",
      "to" : "0xdd4cc09217b3afab3e9987572b93fab348722a06",
      "contractAddress" : "0x23581767a106ae21c074b2276d25e5c3e136a68b",
      "assetId" : "635",
      "timestamp" : 1658935718,
      "block" : 15226400,
      "price" : "19490000000000000000",
      "amountReceived" : "18418050000000000000",
      "currency": "ETH",
      "marketplace" : "GEM"
    },
    {
      "hash" : "0x9410e68426575e1101d6595e2618c37eea320a8a956af7df0de0332ca74d7135",
      "from" : "0x35ca14edabb3cc0d3fa01808dd9ab5deeb59b63a",
      "to" : "0xf6848594078ad7acf80ecf17178d99f00ac97d95",
      "contractAddress" : "0x23581767a106ae21c074b2276d25e5c3e136a68b",
      "assetId" : "7351",
      "timestamp" : 1658935673,
      "block" : 15226398,
      "price" : "25000000000000000000",
      "amountReceived" : "23125000000000000000",
      "currency": "ETH",
      "marketplace" : "OPENSEA"
    },
    {
      "hash" : "0xc4c00aa04e38b6b16bc17579fd67c2b13901ded50e2e087c6212ca9246149708",
      "from" : "0x4bc519c14be5295ec123db8324c53b887feb681b",
      "to" : "0xf9eef0aa05d74f2b099b057e6f807f9904456eba",
      "contractAddress" : "0x23581767a106ae21c074b2276d25e5c3e136a68b",
      "assetId" : "6475",
      "timestamp" : 1658933785,
      "block" : 15226238,
      "price" : "18300000000000000000",
      "amountReceived" : "18300000000000000000",
      "currency": "ETH",
      "marketplace" : "X2Y2"
    },
    {
      "hash" : "0xa3d0bffe1cbbf2da68b2d57f074ee027cd58a3d8bfd7b10b26e22312a94d6dbd",
      "from" : "0x276417be271dbeb696cb97cda7c6982fd89e6bd4",
      "to" : "0x8e0db33daf2bd5237fa3c913518b81c468cb5b1c",
      "contractAddress" : "0x23581767a106ae21c074b2276d25e5c3e136a68b",
      "assetId" : "7584",
      "timestamp" : 1658932269,
      "block" : 15226119,
      "price" : "18250000000000000000",
      "amountReceived" : "18250000000000000000",
      "currency": "ETH",
      "marketplace" : "X2Y2"
    },
    {
      "hash" : "0xd31472121afdd77bfc87b782ea9c6e25985984ded4c09c0dd96aeb64a90f070c",
      "from" : "0x4e07ccaffd70951ee76ba9cc846ca0c858e7d2b1",
      "to" : "0xb2d69ea8405326fdc3f3936fd45826d8613b8045",
      "contractAddress" : "0x23581767a106ae21c074b2276d25e5c3e136a68b",
      "assetId" : "127",
      "timestamp" : 1658927372,
      "block" : 15225765,
      "price" : "19490000000000000000",
      "amountReceived" : "18028250000000000000",
      "currency": "ETH",
      "marketplace" : "OPENSEA"
    },
    {
      "hash" : "0xc103b23f8a75c828eaac0ecb6e920130d74c247acbb83eda803b0940b786ba30",
      "from" : "0xa6aaea8bfa339f602906413cfd22f281eb480d6f",
      "to" : "0x2695a7f0ae9c4d04a04ac17d333345c0b071caf6",
      "contractAddress" : "0x23581767a106ae21c074b2276d25e5c3e136a68b",
      "assetId" : "5503",
      "timestamp" : 1658920760,
      "block" : 15225301,
      "price" : "20000000000000000000",
      "amountReceived" : "18500000000000000000",
      "currency": "ETH",
      "marketplace" : "OPENSEA"
    }
  ]
}

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.