Python Examples

pip install requests

import requests

API_BASE = "https://api.snsauctions.xyz/api/v1"
API_KEY = "sk_your_key_here"


def api_get(path, params=None):
    headers = {"X-API-Key": API_KEY}
    res = requests.get(f"{API_BASE}{path}", headers=headers, params=params, timeout=10)
    res.raise_for_status()
    return res.json()


def api_post(path, payload):
    headers = {"X-API-Key": API_KEY, "Content-Type": "application/json"}
    res = requests.post(f"{API_BASE}{path}", headers=headers, json=payload, timeout=10)
    res.raise_for_status()
    return res.json()

data = api_get("/auctions", {"status": "active", "pageSize": 20})
for auction in data["data"]["auctions"]:
    print(auction["id"], auction["currentPrice"])

payload = {
    "domainNames": ["myname.sol"],
    "type": "standard",
    "startingPrice": 2.5,
    "minBidIncrement": 0.1,
    "durationHours": 24
}
result = api_post("/auctions/create", payload)
print(result)