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