ordinals_marketSales

Query completed 1Sat marketplace sales by name prefix or content type. Prices are satoshis. Pass the last score as from for the next page.

Read as Markdown

Result

Completed sales and nextFrom, as JSON text and structured content.

Permissions

No spending approval is requested by this handler. Public network lookups can still fail or require a compatible service.

Also available through ordinals_read in compact mode.

Inputs and availability

Full catalog · Before wallet setup; Legacy local wallet; Legacy local identity; Local Vault · broadcasting disabled; Local Vault · all roles; Local Vault · payment role only; Project · payments scope; External BRC-100 wallet; Local Vault + sponsor; Droplit wallet

Field	Type / required	Description
q	string Optional	Listing name prefix minLength: 1; maxLength: 200
type	string Optional	Content type, e.g. image/png maxLength: 100
limit	integer Optional	See schema for details. default: 20; minimum: 1; maximum: 100
from	number Optional	Last result's score for the next page minimum: 0

Nested fields are required only when their parent object or array item is supplied.

Full input schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Listing name prefix",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "type": {
      "description": "Content type, e.g. image/png",
      "type": "string",
      "maxLength": 100
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "from": {
      "description": "Last result's score for the next page",
      "type": "number",
      "minimum": 0
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}