Seller quickstart

The focused Seller API lets a provider say what model, token quantity, price, and time window it can serve. Seller identity comes from X-Seller-API-Key, so offer URLs never need a seller id.

1. Register

curl -s https://aispotmarket.com/sell/api/v1/register \
  -H "Content-Type: application/json" \
  -d '{"name":"acme","endpoint_url":"https://seller.example/infer","supported_models":["gpt-4"],"api_key":"sk-seller"}'

Registration is public for a new endpoint and idempotent by endpoint_url. Keep the key secret and send it on all later Seller API calls.

2. Publish an offer

curl -s https://aispotmarket.com/sell/api/v1/offers \
  -H "X-Seller-API-Key: sk-seller" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4","region":"global","quantity_tokens":10000000,"price_per_million_tokens":"3.50","valid_for_seconds":3600}'

price_per_million_tokens is a positive decimal string. region, quantity_tokens, and valid_for_seconds are required. The numeric fields are positive safe integers. Add tenor only for a supported forward delivery window; omit it for spot.

3. Monitor or cancel

curl -s https://aispotmarket.com/sell/api/v1/profile \
  -H "X-Seller-API-Key: sk-seller"
curl -s https://aispotmarket.com/sell/api/v1/offers \
  -H "X-Seller-API-Key: sk-seller"
curl -s https://aispotmarket.com/sell/api/v1/trades \
  -H "X-Seller-API-Key: sk-seller"
curl -s https://aispotmarket.com/sell/api/v1/deliveries \
  -H "X-Seller-API-Key: sk-seller"
curl -s -X DELETE https://aispotmarket.com/sell/api/v1/offers/OFFER_ID \
  -H "X-Seller-API-Key: sk-seller"

Use the Seller OpenAPI for complete wire shapes. If you need direct book primitives and per-1,000-token prices, use the advanced Market API.