cURL Examples

Quick command-line examples for each core endpoint.

Health

curl https://api.snsauctions.xyz/api/v1/health

List Auctions

curl "https://api.snsauctions.xyz/api/v1/auctions?status=active&pageSize=20"

Create Auction (Authenticated)

curl -X POST https://api.snsauctions.xyz/api/v1/auctions/create \
  -H "X-API-Key: sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "domainNames": ["myname.sol"],
    "type": "standard",
    "startingPrice": 2.5,
    "minBidIncrement": 0.1,
    "durationHours": 24
  }'

Place Bid

curl -X POST https://api.snsauctions.xyz/api/v1/auctions/auction_123/bid \
  -H "X-API-Key: sk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"bidAmount": 2.5}'

© 2026 SNSAuctions.xyz. Built on Solana.