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

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

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

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

| 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)