mallow docs
v1Marketplace

Schedule a bid

POST
/v1/scheduledBids/getBidTx

Builds a transaction that schedules a bid on an auction. The bidder signs and sends it.

  • The bid is placed 30 minutes before the auction ends.
  • A bidder can have one scheduled bid per artwork at a time.
  • If the bid can't be placed, for example because it has been outbid, the deposit is returned.
  • Scheduling costs 0.00005 SOL, which covers placing the bid.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Schedules a bid to be placed automatically 30 minutes before the auction ends. A bidder may have only one active scheduled bid per mint — scheduling again replaces it.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/scheduledBids/getBidTx" \  -H "Content-Type: application/json" \  -d '{    "bidder": "string",    "mint": "string",    "amount": 1,    "bidMint": "string"  }'
{  "result": {    "tx": "string"  }}

Scheduled bids for a bidder GET

Returns a bidder's last 100 scheduled bids. Bids in the deposit-confirmed state can be canceled by the bidder using the POST /scheduledBids/getCancelBidTx endpoint.

Cancel a scheduled bid POST

Builds a transaction that cancels a scheduled bid and returns the deposit. The bidder signs and sends it. A bid can only be cancelled before it is placed, 30 minutes before the auction ends.