Venly API
Search…
⌃K

Buy an offer

Endpoint to buy a certain offer
To buy an offer: use POST /fulfillments with type=PURCHASE
post
https://api.venly.market
/fulfillments
Buy an offer

Example

Request

POST https://api.venly.market/fulfillments

Request Body (when buying for yourself)

You need to specify the walletAddress to where the NFT needs to be send.
{
"type": "PURCHASE",
"offerId": "83f9abd1-e82e-4ee1-93b2-d0370f833e6f",
"amount": "1",
"walletAddress": "0xc0ffee254729296a45a3885639AC7E10F9d54979"
}

Request Body (when buying on behalf of your sub-user)

You can specify a sub-user-id, when you want to register a sale for a sub-user (see creating a sub-user). The NFT will be send to the specified wallet-address.
{
"type": "PURCHASE",
"offerId": "83f9abd1-e82e-4ee1-93b2-d0370f833e6f",
"amount": "1",
"walletAddress": "0xc0ffee254729296a45a3885639AC7E10F9d54979",
"userId": "d6805fe3-ec41-4241-a510-5cb418f7bc3c"
}

Response

{
"success": true,
"result": {
"id": "dcba3a7c-0e41-46a9-bd97-7eb59746f94e",
"type": "PURCHASE",
"offerId": "83f9abd1-e82e-4ee1-93b2-d0370f833e6f",
"amount": 1,
"status": "QUEUED",
"creationDate": "2022-04-20T13:26:58.809242",
"pricePerItem": 50,
"buyer": {
"id": "e38336b6-3307-4737-bf82-3a3a39269147",
"nickname": "Pieter",
"email": "[email protected]"
}
}
}