Sales

Sales reads return confirmed sales ordered newest first.

GET /sales

Returns a cursor-paginated feed of confirmed sales.

Query parameters

Name	Type	Required	Default	Description
limit	integer	no	50	Page size. Min 1, max 100.
cursor	string	no		Opaque cursor from pagination.nextCursor.
collectionSlug	string	no		Restrict to one collection. Case-insensitive. Letters, numbers, hyphens, and underscores are allowed.

Example

curl "https://ord.net/api/v1/sales?collectionSlug=wizards&limit=25" \
  -H "Authorization: Bearer $ORD_SESSION_TOKEN"

Response (200)

Field	Type	Description
sales	array	Confirmed sale rows, newest first.
sales[].saleId	string	Sale event identifier.
sales[].saleType	string	internal for ORD.NET-settled sales, external for off-market sales detected from chain data.
sales[].txid	string | null	Settlement transaction id.
sales[].inscriptionId	string	Sold inscription id.
sales[].inscriptionNumber	string	Inscription number as a string.
sales[].inscriptionName	string	Display name of the inscription.
sales[].collection.slug	string | null	Collection slug, if any.
sales[].collection.name	string | null	Collection display name.
sales[].collection.kind	string | null	One of parent_child, gallery.
sales[].collection.verificationStatus	string | null	One of verified, unverified.
sales[].sellerAddress	string | null	Seller ordinals address.
sales[].buyerAddress	string | null	Buyer ordinals address.
sales[].priceSats	integer	Sale price in sats.
sales[].price	number	Sale price in BTC.
sales[].priceUsd	number | null	Sale price in USD using the block-time BTC/USD quote, when available.
sales[].soldAt	ISO 8601 datetime	Sale confirmation time.
sales[].blockHeight	integer	Sale block height.
pagination.pageSize	integer	Items in this page.
pagination.hasNext	boolean	true if more pages exist.
pagination.nextCursor	string | null	Cursor for the next call. null on the last page.

{
  "sales": [
    {
      "saleId": "99",
      "saleType": "external",
      "txid": "abc123...",
      "inscriptionId": "abc123...i0",
      "inscriptionNumber": "12345",
      "inscriptionName": "Inscription 12345",
      "collection": {
        "slug": "wizards",
        "name": "Wizards",
        "kind": "parent_child",
        "verificationStatus": "verified"
      },
      "sellerAddress": "bc1p...",
      "buyerAddress": "bc1p...",
      "priceSats": 50000,
      "price": 0.0005,
      "priceUsd": 50,
      "soldAt": "2026-05-08T18:00:00.000Z",
      "blockHeight": 900101
    }
  ],
  "pagination": {
    "pageSize": 25,
    "hasNext": true,
    "nextCursor": "<opaque-cursor>"
  }
}

Status codes

• 200: sales returned.
• 400: invalid limit, cursor, or collectionSlug.
• 401: missing or invalid bearer token.
• 403: wallet not allowed.
• 429: rate limited.
• 500: internal server error.

Pagination notes

The cursor encodes the last seen sale. Changing collectionSlug between calls invalidates the cursor. Start a new pagination from the beginning.

Unknown collectionSlug filters return an empty page, not 404.