Analytics API

Get market-wide and collection-specific analytics and metrics

GET

/analytics/market

Get market-wide statistics including volume, active auctions, and auction type distribution

Request

GET /api/v1/analytics/market
X-API-Key: sk_live_your_key (optional)

Response

{
  "success": true,
  "data": {
    "activeAuctions": 245,
    "completed24h": 18,
    "totalVolume24h": 156.5,
    "averagePrice24h": 8.69,
    "totalEverVolume": 2458.32,
    "uniqueBuyers": 1042,
    "uniqueSellers": 456,
    "topDomains": [
      {
        "domain": "rare.sol",
        "sales": 12,
        "averagePrice": 25.5,
        "lastSalePrice": 32.0
      }
    ],
    "auctionTypeDistribution": {
      "standard": 120,
      "dutch": 65,
      "reserve": 35,
      "buy_now": 25
    }
  },
  "timestamp": 1234567890
}

Return Fields

activeAuctions
Total number of currently active auctions
completed24h
Number of auctions settled in the last 24 hours
totalVolume24h
Total SOL traded in the last 24 hours
averagePrice24h
Average selling price in the last 24 hours (in SOL)
totalEverVolume
Cumulative all-time SOL traded
uniqueBuyers/Sellers
Total unique participants in auctions
auctionTypeDistribution
Breakdown of active auctions by type (standard, dutch, reserve, buy_now)
GET

/analytics/collections

Get collection-specific analytics including volume trends, floor prices, and activity metrics

Request

GET /api/v1/analytics/collections
X-API-Key: sk_live_your_key (optional)

Response

{
  "success": true,
  "data": {
    "collections": [
      {
        "slug": "three-letter",
        "name": "3-Letter Domains",
        "activeCount": 45,
        "completedCount": 320,
        "totalVolume": 856.32,
        "volume24h": 45.2,
        "floorPrice": 12.5,
        "averagePrice": 22.8,
        "trend": [38.5, 41.2, 39.8, 42.1, 40.9, 43.5, 45.2],
        "lastUpdated": 1234567890
      }
    ],
    "generatedAt": 1234567890
  },
  "timestamp": 1234567890
}

Return Fields

slug
Unique identifier for the collection (e.g., "three-letter")
name
Human-readable collection name
activeCount
Number of active auctions in this collection
floorPrice
Lowest current asking price in this collection (in SOL)
trend
7-day volume trend as array of daily SOL traded amounts

Rate Limits

Public (Unauthenticated)

50 requests/minute

Authenticated (API Key)

Uses per-key rate limit (default 200 requests/minute, configurable)

Examples

Fetch market statistics:

curl -X GET https://api.snsauctions.xyz/api/v1/analytics/market

Fetch with API authentication:

curl -X GET https://api.snsauctions.xyz/api/v1/analytics/collections \
  -H "X-API-Key: sk_live_your_key"

© 2026 SNSAuctions.xyz. Built on Solana.