---
title: "Get Listings"
method: GET
path: "/v2/ord/btc/raresats/listings"
tags: ["Rare Sats"]
---

# Get Listings

`GET /v2/ord/btc/raresats/listings`

Get Rare Sats Listings by a Variety of Filters and Sorting Orders

## Query parameters

- `sortBy` string[]
- `limit` integer
- `offset` integer
- `satributes` SatributesSchema[]
- `minListedAt` integer
- `maxListedAt` integer
- `minPrice` integer
- `maxPrice` integer
- `minUtxoSize` integer
- `maxUtxoSize` integer
- `minSatRange` integer
- `maxSatRange` integer
- `minBlockNumber` integer
- `maxBlockNumber` integer
- `minBlockTimestamp` integer
- `maxBlockTimestamp` integer

## Response `200`

Successful response

- RareSatsGetListingsSchema[]
  - `tokens` RareSatsGetListingsItem[]
    - `id` string
    - `genesisTransaction` string
    - `genesisTransactionBlockTime` string
    - `genesisTransactionBlockHash` string
    - `genesisTransactionBlockHeight` number
    - `outputValue` number
    - `owner` string
    - `listed` boolean
    - `listedAt` string
    - `listedPrice` number
    - `listedSellerReceiverAddress` string
    - `minBlockHeight` number
    - `maxBlockHeight` number
    - `minBlockTime` string
    - `maxBlockTime` string
    - `minSatRange` number
    - `maxSatRange` number
    - `minUnitPrice` number
    - `maxUnitPrice` number
    - `satRanges` RareSatsSatRanges[]
      - `id` string
      - `from` number
      - `to` number
      - `parentFrom` number
      - `parentTo` number
      - `satributes` SatributesSchema[]
      - `amount` number
      - `sequence` number
      - `unitPrice` number
      - `blockInfo` BlockInfoSchema
        - `blockHash` string
        - `blockHeight` number
        - `blockTime` string

---

[API](https://skmtc.net/magiceden/apis/magic-eden-api.md) · [All operations](https://skmtc.net/magiceden/apis/magic-eden-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/magiceden/magic-eden-api/revisions/66028b292693/schema)