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

Parameter	Type	Default	Description
page	integer	1	Page number for pagination
pageSize	integer	20	Results per page (max 100)
status	string	—	Filter by: active, ended, upcoming, cancelled
type	string	—	Filter by: standard, dutch, reserve, buy_now
seller	string	—	Filter by seller wallet address (base58)
search	string	—	Search by domain name, title, or seller
sortBy	string	endTime	Sort by: endTime, currentPrice, totalBids, createdAt
sortOrder	string	asc	asc 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

Tier	Requests / minute
Public (no API key)	100
Authenticated	1,000

Overview

Bidding

Follow Notify Join Discord