# 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.

## 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.

## Definition 1 (full)

Registered in: 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.

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.

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

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "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"
}
```

[All tools](https://bsvmcp.com/docs/tools)