Bid on an Offer (Auction)
How to bid on an offer.
The Market API will be discontinued, in Q3 2024 we will be sunsetting this product
Bidding can only be done on Offers of
type: AUCTION
Request Endpoint: reference
POST /offers/{id}/bid
| Parameter | Param Type | Description | Data Type | Mandatory |
|---|---|---|---|---|
{id} | Path | The offer ID to bid on | String | ✅ |
amount | Body | The amount (USDC) of the bid on the offer | Number | ❌ |
userId | Body | The user Id of a sub-user performing the bid | String | ❌ |
Example Request:
POST https://api.venly.market/offers/221f0aa1-5ebd-471d-b173-f31902d5338e/bid
{
"amount": 200,
"userId": "54e31250-12b0-40e6-a8e7-130a41f55dd3"
}
Response Body:
{
"success": true,
"result": {
"id": "221f0aa1-5ebd-471d-b173-f31902d5338e",
"nft": {
"id": "23",
"address": "0xb3ccba9310e123e1d5b15b76bbc0165e410f492e",
"chain": "MATIC",
"name": "Chuck Fungible NonFungible",
"description": "Chuck is a Male Tall Chicken Who is the Leader of The Chicken Siblings. He is Cool, Daring and Wacky. He can be Selfish and Stubborn When it Comes To Challenges, But he is An True Softie when it Comes To His Siblings. In Rebel to the Beak, It revealed that He is Allergic to Monstonuts and In The Good, The Bad and The Clucky, It also Revealed that He Used to Be one Of the Scouts from Slurp,s Little Cowboys Scout Camp along With Finley, Ainta and Hugo. He is the youngest of the three.",
"imageUrl": "https://static.wikia.nocookie.net/parody/images/4/42/74915084_10162764640400387_6139958579186106368_o.jpg",
"url": "https://en.wikipedia.org/wiki/Space_Chickens_in_Space",
"imagePreviewUrl": "https://static.wikia.nocookie.net/parody/images/4/42/74915084_10162764640400387_6139958579186106368_o.jpg",
"imageThumbnailUrl": "https://static.wikia.nocookie.net/parody/images/4/42/74915084_10162764640400387_6139958579186106368_o.jpg",
"animationUrls": [
{
"type": "video",
"value": "https://img.arkane.network/marketing/SpaceChickens/space_chickens_trailer.mp4"
},
{
"type": "audio",
"value": "https://file-examples-com.github.io/uploads/2017/11/file_example_WAV_10MG.wav"
}
],
"fungible": false,
"attributes": [
{
"type": "property",
"name": "Talent",
"value": "Leadership"
},
{
"type": "property",
"name": "Allergic",
"value": "Monstonuts"
},
{
"type": "property",
"name": "Hobby",
"value": "Scouts"
},
{
"type": "stat",
"name": "Cool",
"value": "9",
"displayType": "number",
"maxValue": 10
},
{
"type": "stat",
"name": "Daring",
"value": "8",
"displayType": "number",
"maxValue": 10
},
{
"type": "stat",
"name": "Noise",
"value": "8",
"displayType": "number",
"maxValue": 10
},
{
"type": "stat",
"name": "Age",
"value": "3",
"displayType": "number"
},
{
"type": "boost",
"name": "Crafting",
"value": "+5",
"displayType": "boost_number"
},
{
"type": "boost",
"name": "Leadership",
"value": "+10",
"displayType": "boost_number"
},
{
"type": "system",
"name": "tokenTypeId",
"value": "13"
},
{
"type": "property",
"name": "maxSupply",
"value": "25"
}
],
"contract": {
"chain": "MATIC",
"address": "0xb3ccba9310e123e1d5b15b76bbc0165e410f492e",
"count": 0,
"name": "Alex test",
"description": "Test contract by alex.",
"symbol": "ALTE",
"url": "https://en.wikipedia.org/wiki/Space_Chickens_in_Space",
"imageUrl": "https://static.wikia.nocookie.net/logopedia/images/a/aa/Space_Chickens_in_Space.jpg",
"media": [
{
"type": "image",
"value": "https://dg31sz3gwrwan.cloudfront.net/fanart/355763/1357791-0-q80.jpg"
}
],
"verified": false,
"premium": false,
"categories": []
},
"collectionIdentifier": "d62fdbdb-3d2b-4671-863e-e4a419962e9c"
},
"sellerId": "67682a06-bbab-4b2e-a885-76dc4a7130a3",
"sellerNickname": "DiplomaticWalrus",
"sellerAddress": "0xc1043a980f5a50b38d23d281f564da50b0e8cf2e",
"startDate": "2022-09-28T12:54:04.991549Z",
"endDate": "2022-12-28T13:54:02.977Z",
"type": "AUCTION",
"status": "READY",
"dataToSign": "221f0aa1-5ebd-471d-b173-f31902d5338e_0xc1043a980f5a50b38d23d281f564da50b0e8cf2e_0xe885A1cD1b67bDC352A113AB2e6A5Fc6C924F888_23",
"txApprove": "0x5e6ca3b279fc007d4f71e76163dd91a19b86212784eec2aa890f1959328e12c7",
"txInCustody": "0x3e09871cf107350401e265a53846be415042018db5e29355cd570a551a818980",
"createdOn": "2022-09-28T12:54:04.993438Z",
"createdBy": "67682a06-bbab-4b2e-a885-76dc4a7130a3",
"modifiedOn": "2022-10-04T10:19:10.642527Z",
"modifiedBy": "0b0b9048-1d7b-4095-a720-21ab2d80b6e4",
"signed": true,
"currency": "USDC",
"privateOffer": false,
"seller": {
"id": "67682a06-bbab-4b2e-a885-76dc4a7130a3",
"nickname": "DiplomaticWalrus"
},
"amountPurchased": 0,
"amountReimbursed": 0,
"amountTerminated": 0,
"visibility": "PUBLIC",
"minimumBid": 100,
"bids": [
{
"id": "a96196be-8e29-469d-a25f-9d7c4612a208",
"user": {
"id": "e38336b6-3307-4737-bf82-3a3a39269147",
"nickname": "Pieter"
},
"amount": 200,
"createdOn": "2022-10-04T10:19:10.55525Z"
},
{
"id": "ebf8a872-0267-4d2a-89f8-05aad80b2c31",
"user": {
"id": "0b0b9048-1d7b-4095-a720-21ab2d80b6e4",
"nickname": "FascinatingVicuña"
},
"amount": 109,
"offerId": "221f0aa1-5ebd-471d-b173-f31902d5338e",
"createdOn": "2022-10-03T12:25:49.999864Z"
},
{
"id": "d8ff9a38-7545-4b16-8c47-57bf02b41202",
"user": {
"id": "0b0b9048-1d7b-4095-a720-21ab2d80b6e4",
"nickname": "FascinatingVicuña"
},
"amount": 100,
"offerId": "221f0aa1-5ebd-471d-b173-f31902d5338e",
"createdOn": "2022-09-28T15:49:06.741135Z"
}
],
"highestBid": {
"id": "a96196be-8e29-469d-a25f-9d7c4612a208",
"user": {
"id": "e38336b6-3307-4737-bf82-3a3a39269147",
"nickname": "Pieter"
},
"amount": 200,
"createdOn": "2022-10-04T10:19:10.55525Z"
}
}
}
Updated 6 months ago