ordinals_marketListings

Search active 1Sat marketplace listings by name prefix or content type. Prices are satoshis. Pass the last score as from for the next page. Availability is checked again when purchasing.

Read as Markdown

Result

Listings and nextFrom, as JSON text and structured content. Prices are satoshis; a null nextFrom ends pagination.

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"
}