Auctions API

Reference documentation for auction-related endpoints

List Auctions

GET /api/v1/auctions

Retrieve a paginated list of auctions with optional filtering and sorting. Data is fetched live from the Solana blockchain.

Query Parameters

ParameterTypeDefaultDescription
pageinteger1Page number for pagination
pageSizeinteger20Results per page (max 100)
statusstringFilter by: active, ended, upcoming, cancelled
typestringFilter by: standard, dutch, reserve, buy_now
sellerstringFilter by seller wallet address (base58)
searchstringSearch by domain name, title, or seller
sortBystringendTimeSort by: endTime, currentPrice, totalBids, createdAt
sortOrderstringascasc or desc

Example Request

GET /api/v1/auctions?status=active&type=standard&sortBy=endTime&page=1

Response

{
  "success": true,
  "data": {
    "auctions": [
      {
        "id": "7K8mN2qPxR...",        // Auction PDA (base58 public key)
        "seller": "SellerWallet...",
        "domains": ["myname.sol"],
        "type": "standard",
        "status": "active",
        "startingPrice": 2.5,
        "currentPrice": 4.2,
        "minBidIncrement": 0.1,
        "topBidder": "BidderWallet...",
        "totalBids": 5,
        "startTime": 1711440000000,    // Unix timestamp (ms)
        "endTime": 1711612800000,      // Unix timestamp (ms)
        "snipeProtectionEnabled": true,
        "snipeExtensionSeconds": 300,
        "featured": false,
        "category": "Short Names",
        "tags": ["SNS", ".sol", "Short Names"],
        "createdAt": 1711440000000
      }
    ],
    "total": 42,
    "page": 1,
    "pageSize": 20
  },
  "timestamp": 1711463000000
}

Get Auction Details

GET /api/v1/auctions/:id

Retrieve detailed information about a specific auction. The :id is the auction PDA — a base58-encoded Solana public key returned by /auctions/create.

Response

{
  "success": true,
  "data": {
    "id": "7K8mN2qPxR...",
    "seller": "SellerWallet...",
    "domains": ["myname.sol"],
    "type": "standard",
    "status": "active",
    "startingPrice": 2.5,
    "currentPrice": 4.2,
    "reservePrice": null,
    "minBidIncrement": 0.1,
    "topBidder": "BidderWallet...",
    "totalBids": 5,
    "startTime": 1711440000000,
    "endTime": 1711612800000,
    "snipeProtectionEnabled": true,
    "snipeExtensionSeconds": 300,
    "bids": [
      {
        "bidder": "BidderWallet...",
        "amount": 4.2,
        "timestamp": 1711450000000,
        "transactionId": "5gkxsVjnwv..."
      }
    ],
    "featured": false,
    "category": "Short Names",
    "tags": ["SNS", ".sol", "Short Names"],
    "createdAt": 1711440000000
  },
  "timestamp": 1711463000000
}

Rate Limits

TierRequests / minute
Public (no API key)100
Authenticated1,000

© 2026 SNSAuctions.xyz. Built on Solana.