ordinals_searchInscriptions

Search indexed outputs by 1Sat event/topic/owner key (e.g. own:ADDRESS). Returns inscription and MAP metadata when indexed. This is an index-key search, not free-text search; use marketListings.q for listing names.

Read as Markdown

Result

Indexed outputs and any available inscription metadata, as JSON text.

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
key	string Required	Index key, e.g. own:ADDRESS, ev:EVENT, or tp:TOPIC minLength: 1; maxLength: 300
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": {
    "key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "Index key, e.g. own:ADDRESS, ev:EVENT, or tp:TOPIC"
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "from": {
      "description": "Last result's score for the next page",
      "type": "number",
      "minimum": 0
    }
  },
  "required": [
    "key"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}