mallow docs
v2 (Beta)TransactionsAuctions

Release token refund

POST
/v2/tx/auctions/push-bid-refund

Builds a transaction that releases a bidder's held token refund to a bidder-owned token account, without the bidder signing. payer signs and pays. Without destination, the refund goes to the bidder's associated token account, created at payer's expense if missing; if that account can't receive the refund, a new sponsor-funded token account owned by the bidder is created instead, and the transaction comes back partially signed. Keep that signature when payer signs.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v2/tx/auctions/push-bid-refund" \  -H "Content-Type: application/json" \  -d '{    "payer": "string",    "bidder": "string",    "mint": "string"  }'
{  "result": {    "tx": "string"  }}

Release SOL refund POST

Builds a transaction that releases a bidder's held SOL refund to their wallet, without the bidder signing. Anyone can sign and pay as payer. It works only once the wallet can receive SOL; to send the refund elsewhere, the bidder uses POST /v2/tx/auctions/withdraw-bid-refund.

Close refund claim POST

Builds a transaction that closes an empty refund claim and returns its rent to rentPayer, the wallet that paid it, who signs. Any refund left in the claim must be paid out first. Find claims with GET /v2/auctions/bid-refund-claims/{rentPayer}.