Settlement

Finalize completed auctions and transfer domain ownership

POST

/api/v1/auctions/:id/settle

Settle a completed auction. The :id is the auction PDA (base58 public key). Settlement is only valid for english auction type — dutch and buy-now auctions self-settle when a bid is placed and do not use this endpoint.

Settlement transactions are signed and broadcast by the server. Unlike create/bid, you receive a confirmed transaction signature, not an unsigned base64 transaction.

Request

POST /api/v1/auctions/7K8mN2qPxR.../settle
X-API-Key: sk_live_your_key_here

Response

{
  "success": true,
  "data": {
    "transactionId": "5X7fY9...", // Confirmed Solana transaction signature
    "auctionId": "7K8mN2qPxR...",
    "status": "settled",
    "winner": "WinnerWalletAddress...",
    "winnerAmount": 2.5,
    "timestamp": 1711464000000
  }
}

Status Codes

200

Auction settled; domain transferred.

400

Auction has not ended yet (AUCTION_NOT_ENDED), or auction type is not english (dutch and buy_now self-settle).

401

Missing or invalid API key.

404

No auction found for the given PDA.

500

On-chain transaction failed. Check cluster status.

503

RPC node unavailable. Retry with exponential backoff.

Previous
Bidding
Next
Users & Profiles

© 2026 SNSAuctions.xyz. Built on Solana.

FollowNotifyJoin Discord