Bids
List of NFT Exchange Bid Endpoints.
All Bids
/bids
GET https://explorer.protokol.sh/api/nft/exchange/bids
Return all bids
Query Parameters
page
integer
The number of page that will be returned
limit
integer
The number of resources per page
orderBy
string
Order by specific parameter (asc or desc) Example: orderBy=id:asc
transform
boolean
Returns modified or raw data
{
"meta": {
"totalCountIsEstimate": true,
"count": 2,
"pageCount": 1,
"totalCount": 2,
"next": null,
"previous": null,
"self": "/nft/exchange/bids?transform=true&page=1&limit=100",
"first": "/nft/exchange/bids?transform=true&page=1&limit=100",
"last": "/nft/exchange/bids?transform=true&page=1&limit=100"
},
"data": [
{
"id": "73f15a9d387035ac8f860e9f6bce63919735f8cf4eee05048ac31b935d3d69a1",
"senderPublicKey": "02def27da9336e7fbf63131b8d7e5c9f45b296235db035f1f4242c507398f0f21d",
"nftBid": {
"auctionId": "08466d59b86622152c643558c03e4037454dcaf4d8188af876812c79d433ae20",
"bidAmount": "150000000000"
},
"timestamp": {
"epoch": 143238112,
"unix": 1633339312,
"human": "2021-10-04T09:21:52.000Z"
}
},
{
"id": "ce81232de97526c7be16dc66f7efba4f8f92a686e8b8d1250f48a87dacd45945",
"senderPublicKey": "02def27da9336e7fbf63131b8d7e5c9f45b296235db035f1f4242c507398f0f21d",
"nftBid": {
"auctionId": "91221ffc0838fde5983e5ffe32c427b5720dc5703df6b89f1126fa7f62ebd964",
"bidAmount": "150000000000"
},
"timestamp": {
"epoch": 143238328,
"unix": 1633339528,
"human": "2021-10-04T09:25:28.000Z"
}
}
]
}Examples
curl https://explorer.protokol.sh/api/nft/exchange/bidsconst response = connection.NFTExchangeApi("bids").getAllBids();
>>> Promise<ApiResponse<BidsResource>>Bids By Id
/bids/:id
GET https://explorer.protokol.sh/api/nft/exchange/bids/:id
Returns bid by id
Path Parameters
id
string
The identifier of the bid to be retrieved
Query Parameters
transform
boolean
Returns modified or raw data
{
"data": {
"id": "73f15a9d387035ac8f860e9f6bce63919735f8cf4eee05048ac31b935d3d69a1",
"senderPublicKey": "02def27da9336e7fbf63131b8d7e5c9f45b296235db035f1f4242c507398f0f21d",
"nftBid": {
"auctionId": "08466d59b86622152c643558c03e4037454dcaf4d8188af876812c79d433ae20",
"bidAmount": "150000000000"
},
"timestamp": {
"epoch": 143238112,
"unix": 1633339312,
"human": "2021-10-04T09:21:52.000Z"
}
}
}{
"statusCode": 404,
"error": "Not Found",
"message": "Bid not found"
}{
"statusCode": 422,
"error": "Unprocessable Entity",
"message": "\"id\" length must be 64 characters long"
}Examples
curl https://explorer.protokol.sh/api/nft/exchange/bid/1d1757bc7e598fd73f0ec670e1f2c517d7d9a2a94d447bd5daa0a9384ebd4e7econst response = connection.NFTExchangeApi("bids").getBidById("VALID_ID");
>>> Promise<ApiResponse<BidsResource>>Bids Wallet
/bids/:id/wallets
GET https://explorer.protokol.sh/api/nft/exchange/bids/:id/wallets
Returns wallet owning the bid
Path Parameters
id
string
The identifier of the auction
{
"data": {
"address": "ANBkoGqWeTSiaEVgVzSKZd3jS7UWzv9PSo",
"publicKey": "03287bfebba4c7881a0509717e71b34b63f31e40021c321f89ae04f84be6d6ac37",
"nft": {
"collections": [
...
],
"auctions": [
{
"auctionId": "08466d59b86622152c643558c03e4037454dcaf4d8188af876812c79d433ae20",
"nftIds": [
"4f1f337873d530838dba06c9ec256cfd8a2acf7a94e87fbb0cb4c7304d3e6788"
],
"bids": [
"6cb1e1b85a6a87108ae37b2e1ca94732bc609caa8ab6d992395b143e3d157cf9"
]
}
],
"lockedBalance": "0"
}
}
}{
"statusCode": 404,
"error": "Not Found",
"message": "Bid not found or it was already accepted/canceled"
}{
"statusCode": 422,
"error": "Unprocessable Entity",
"message": "\"id\" length must be 64 characters long"
}Examples
curl https://explorer.protokol.sh/api/nft/exchange/bids/1d1757bc7e598fd73f0ec670e1f2c517d7d9a2a94d447bd5daa0a9384ebd4e7e/walletsconst response = connection.NFTExchangeApi("auctions").getAuctionsWallets("VALID_ID");
>>> Promise<ApiResponse<AuctionsWallet>>Search Bids
/bids/search
POST https://explorer.protokol.sh/api/nft/exchange/bids/search
Seach auctions
Query Parameters
page
integer
The number of the page that will be returned
limit
integer
The number of resources per page
orderBy
string
Order by specific parameter (asc or desc) Example: orderBy=id:asc
transform
boolean
Returns modified or raw data
Request Body
senderPublicKey
string
Public key of a sender
auctionId
array
Id of an auction
bidAmount
string
Amount of a bid
{
"meta": {
"totalCountIsEstimate": true,
"count": 3,
"pageCount": 1,
"totalCount": 3,
"next": null,
"previous": null,
"self": "/nft/exchange/bids/search?transform=true&page=1&limit=100",
"first": "/nft/exchange/bids/search?transform=true&page=1&limit=100",
"last": "/nft/exchange/bids/search?transform=true&page=1&limit=100"
},
"data": [
{
"id": "73f15a9d387035ac8f860e9f6bce63919735f8cf4eee05048ac31b935d3d69a1",
"senderPublicKey": "02def27da9336e7fbf63131b8d7e5c9f45b296235db035f1f4242c507398f0f21d",
"nftBid": {
"auctionId": "08466d59b86622152c643558c03e4037454dcaf4d8188af876812c79d433ae20",
"bidAmount": "150000000000"
},
"timestamp": {
"epoch": 143238112,
"unix": 1633339312,
"human": "2021-10-04T09:21:52.000Z"
}
},
...
]
}Examples
curl --request POST \
--url https://explorer.protokol.sh/api/nft/exchange/bids/search \
--header 'content-type: application/json' \
--data '{
"bidAmount": "150000000000"
}'const response = connection.NFTExchangeApi("bids").searchByBid({
auctionId: "VALID_AUCTION_ID",
senderPublicKey: "VALID_SENDER_PUBLIC_KEY",
bidAmount: "BID_AMOUNT",
});
>>> Promise<ApiResponse<BidCanceled>>Canceled Bids
/bids/canceled
GET https://explorer.protokol.sh/api/nft/exchange/bids/canceled
Returns canceled bids transactions
Query Parameters
page
integer
The number of the page that will be returned
limit
integer
The number of resources per page
orderBy
string
Order by specific parameter (asc or desc) Example: orderBy=id:asc
transform
boolean
Returns modified or raw data
{
"meta": {
"totalCountIsEstimate": true,
"count": 1,
"pageCount": 1,
"totalCount": 1,
"next": null,
"previous": null,
"self": "/nft/exchange/bids/canceled?transform=true&page=1&limit=100",
"first": "/nft/exchange/bids/canceled?transform=true&page=1&limit=100",
"last": "/nft/exchange/bids/canceled?transform=true&page=1&limit=100"
},
"data": [
{
"id": "59da5fbc385ff7952eeda4829f4f0f8c57ab39930c1a91ac5cecea2ea5f0a9a0",
"senderPublicKey": "02def27da9336e7fbf63131b8d7e5c9f45b296235db035f1f4242c507398f0f21d",
"nftBidCancel": {
"bidId": "73f15a9d387035ac8f860e9f6bce63919735f8cf4eee05048ac31b935d3d69a1"
},
"timestamp": {
"epoch": 143238184,
"unix": 1633339384,
"human": "2021-10-04T09:23:04.000Z"
}
}
]
}Examples
curl https://explorer.protokol.sh/api/nft/exchange/bids/canceledCanceled Bids By Id
/bids/canceled/:id
GET https://explorer.protokol.sh/api/nft/exchange/bids/canceled/:id
Returns canceled bid transaction by id
Path Parameters
id
string
The identifer of canceled bid to be retrieved
Query Parameters
transform
boolean
Returns modified or raw data
{
"data": {
"id": "59da5fbc385ff7952eeda4829f4f0f8c57ab39930c1a91ac5cecea2ea5f0a9a0",
"senderPublicKey": "02def27da9336e7fbf63131b8d7e5c9f45b296235db035f1f4242c507398f0f21d",
"nftBidCancel": {
"bidId": "73f15a9d387035ac8f860e9f6bce63919735f8cf4eee05048ac31b935d3d69a1"
},
"timestamp": {
"epoch": 143238184,
"unix": 1633339384,
"human": "2021-10-04T09:23:04.000Z"
}
}
}{
"statusCode": 404,
"error": "Not Found",
"message": "Bid not found"
}{
"statusCode": 422,
"error": "Unprocessable Entity",
"message": "\"id\" length must be 64 characters long"
}Examples
curl https://explorer.protokol.sh/api/nft/exchange/bids/canceled/3c26dee62a937aaf49c25e64d2776117362e9dc30dd6f27c839081d1e44608bcconst response = connection.NFTExchangeApi("bids").getCanceledBidById("VALID_ID");
>>> Promise<ApiResponse<BidCanceled>>Last updated
Was this helpful?