These docs are for v2.0. Click to read the latest docs for v3.0.

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
ParameterParam TypeDescriptionData TypeMandatory
{id}PathThe offer ID to bid onString
amountBodyThe amount (USDC) of the bid on the offerNumber
userIdBodyThe user Id of a sub-user performing the bidString

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"
        }
    }
}