ordinals_searchInscriptions

Search indexed outputs by 1Sat event/topic/owner key (e.g

Read as Markdown

Result

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

Permissions

No wallet required.

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

Full tool description

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.

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