List a single ERC-721 NFT for sale on the Dew marketplace.
When generating the salt required for signature using Seaport.js generateRandomSalt(),
the domain parameter has to be set to dew. Otherwise the signature will be rejected.
POST
/open/v1/{network_id}/orders/add
curl \
-X POST https://api.dewapi.com/open/v1/137/orders/add \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{"parameters":{"offerer":"string","offer":[{"itemType":2,"token":"string","identifierOrCriteria":42,"startAmount":42,"endAmount":42}],"consideration":[{"itemType":0,"token":"string","identifierOrCriteria":42,"startAmount":42,"endAmount":42,"recipient":"string"}],"startTime":42,"endTime":42,"orderType":0,"zone":"0x0000000000000000000000000000000000000000","zoneHash":"string","salt":"string","conduitKey":"string","totalOriginalConsiderationItems":42,"counter":"1"},"signature":"0x","protocol_address":"0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC"}'
Request example
{
"parameters": {
"offerer": "string",
"offer": [
{
"itemType": 2,
"token": "string",
"identifierOrCriteria": 42,
"startAmount": 42,
"endAmount": 42
}
],
"consideration": [
{
"itemType": 0,
"token": "string",
"identifierOrCriteria": 42,
"startAmount": 42,
"endAmount": 42,
"recipient": "string"
}
],
"startTime": 42,
"endTime": 42,
"orderType": 0,
"zone": "0x0000000000000000000000000000000000000000",
"zoneHash": "string",
"salt": "string",
"conduitKey": "string",
"totalOriginalConsiderationItems": 42,
"counter": "1"
},
"signature": "0x",
"protocol_address": "0x00000000000000ADc04C56Bf30aC9d3c0aAF14dC"
}
Response examples (200)
{
"code": 0,
"data": [
{
"source": 1,
"price": "49000000000000000",
"currency": "0x0000000000000000000000000000000000000000",
"price_usd": "0.1",
"id": 1,
"network_id": 137,
"nft": {
"owner": "0x40415c1c0e7a8ff3e184b51a94a2fc5b92df9434",
"contract": "0xa131b877B12B0Ae8BB7da7229b8a1095881497A6",
"token_id": "1",
"name": "BAYC #1",
"rank": 1,
"status": 0
},
"contract": {
"contract": "0x8a90CAb2b38dba80c64b7734e58Ee1dB38B8992e",
"name": "Doodle",
"symbol": "DOODLE",
"icon_url": "nfts/qt5xtfvkajlhva1.jpg",
"slug": "doodles-official",
"verified": true,
"show_rarity": false
},
"order_hash": "0x41a2753400f805db148079f60355df470aece45941a45cb96a25ab5d24e4c243",
"maker": "0x40415c1c0e7a8ff3e184b51a94a2fc5b92df9434",
"taker": "string",
"status": 0,
"created_at": 1654983000,
"listed_at": 1654983000,
"expired_at": 1654999000,
"is_offer": false,
"updated_at": 1654983000,
"amount": "1",
"remain": "1"
}
]
}
Response examples (400)
{
"code": 3000,
"error": "this is an error message",
"errors": [
{
"field": [
"error message"
]
}
]
}