API

zAuction bid data management

post
Create a bid

https://api.cakes.com/api/bids/{nftId}
Get all bids on an NFT.
Request
Response
Request
Path Parameters
nftId
required
string
Token ID stored on the NFT's contract
Body Parameters
bidAmount
required
string
Bid amount in Wei
account
required
string
Bidder's address
auctionId
required
string
Bidder-defined salt
tokenId
required
string
Token ID stored at contractAddress
contractAddress
required
string
Address of the NFT's deployed contract
bidMessage
required
string
Encoded bid data message to sign
minimumBid
required
string
Minimum bid step in Wei
startBlock
required
string
Block the bid can now be accepted
expireBlock
required
string
Block at which the bid can no longer be accepted
signedMessage
required
string
Signed bidMessage
Response
200: OK
Bid successful
{ "message" : "Ok" }
400: Bad Request
{ "message" : "{param} not found" }
405: Method Not Allowed
Bid amount was not greater than the current bid
{ "message" : "New bid amount must be greater than current bid amount" }

post
Encode bid payload

https://zproxy.ilios.dev/api/bid
Returns a bid data message to sign, an randomly-generated auctionId, and an nftId hash
Request
Response
Request
Body Parameters
bidAmount
optional
string
Bid amount in Wei
tokenId
optional
string
Token ID stored at contractAddress
contractAddress
optional
string
Address of the NFT's deployed contract
minimumBid
optional
string
Minimum bid step amount
startBlock
optional
string
Block at which the bid can now be accepted
expireBlock
optional
string
Block at which the bid can no longer be accepted
Response
200: OK
Successful bid data encoding
{
.
}
500: Internal Server Error
Invalid input parameter.
{ "message": "invalid BigNumber string" }

get
Get all bids for NFT

https://zproxy.ilios.dev/api/bids/{nftId}
Get full bid history on an NFT
Request
Response
Request
Path Parameters
nftId
optional
string
NFT hash in the form keccak256(contractAddress + tokenId)
Response
200: OK
[
{"bidder":"0xFG001D397840FC3bAE47Aac6FbC49DBE1B7A4GHI","bidAmt":9,"bidMsg":"0x7ca286608e8e035425267b8e93e1486715a8668e759445112dab2113ada937d4"},
{"bidder":"0xAC001D397840FC3bAE47Aac6FbC49DBE1B7A4ABC","bidAmt":11,"bidMsg":"0xb548c89ab70b1b6001f1cebfe837425c2d132b7eb11cde7b0d67c8658282c07d"},
{"bidder":"0xDE001D397840FC3bAE47Aac6FbC49DBE1B7A4DEF","bidAmt":12,"bidMsg":"0x42eec77afcba6a65e33e87aae44dedfc87e5dd8606ef5c0ee7981811d0cb0ff5"}
]
500: Internal Server Error
The given parameters do not match any nft ID
{ "message": "The specified key does not exist." }