ordinals_marketListings

Discover and filter marketplace listings for Bitcoin SV ordinals, including NFTs, BSV-20, and BSV-21 tokens. Retrieve asset details, prices, and seller information with sorting and pagination options.

Instructions

Retrieves current marketplace listings for Bitcoin SV ordinals with flexible filtering. Supports multiple asset types (NFTs, BSV-20 tokens, BSV-21 tokens) through a unified interface. Results include listing prices, details about the assets, and seller information.

Input Schema

Name	Required	Description	Default
`args`	Yes

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "args": {
      "additionalProperties": false,
      "properties": {
        "address": {
          "description": "Bitcoin address",
          "type": "string"
        },
        "dir": {
          "default": "desc",
          "description": "Sort direction (asc or desc)",
          "enum": [
            "asc",
            "desc"
          ],
          "type": "string"
        },
        "id": {
          "description": "Token ID in outpoint format",
          "type": "string"
        },
        "limit": {
          "default": 20,
          "description": "Number of results (1-100, default 20)",
          "maximum": 100,
          "minimum": 1,
          "type": "integer"
        },
        "maxPrice": {
          "description": "Maximum price in satoshis",
          "type": "number"
        },
        "mime": {
          "description": "MIME type filter",
          "type": "string"
        },
        "minPrice": {
          "description": "Minimum price in satoshis",
          "type": "number"
        },
        "num": {
          "description": "Inscription number",
          "type": "string"
        },
        "offset": {
          "default": 0,
          "description": "Pagination offset",
          "minimum": 0,
          "type": "integer"
        },
        "origin": {
          "description": "Origin outpoint",
          "type": "string"
        },
        "pending": {
          "default": false,
          "description": "Include pending sales",
          "type": "boolean"
        },
        "sort": {
          "default": "recent",
          "description": "Sort method (recent, price, num, height, price_per_token)",
          "enum": [
            "recent",
            "price",
            "num",
            "height",
            "price_per_token"
          ],
          "type": "string"
        },
        "tick": {
          "description": "Token ticker symbol",
          "type": "string"
        },
        "tokenType": {
          "default": "all",
          "description": "Type of token to search for (nft, bsv20, bsv21, or all)",
          "enum": [
            "nft",
            "bsv20",
            "bsv21",
            "all"
          ],
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "required": [
    "args"
  ],
  "type": "object"
}

Bitcoin SV MCP Server

ordinals_marketListings

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Bitcoin SV MCP Server

Related Tools