---
title: "Get Rare Sats by Address"
method: GET
path: "/v2/ord/btc/raresats/wallet/utxos"
tags: ["Rare Sats"]
---

# Get Rare Sats by Address

`GET /v2/ord/btc/raresats/wallet/utxos`

Get Rare Sats by Address

## Query parameters

- `walletAddress` string, required
- `listed` boolean
- `limit` integer
- `offset` string

## Response `200`

Successful response

- object
  - `tokens` object[], required
    - `chain` string
    - `collection` object
      - `chain` string
      - `imageURI` string
      - `name` string
      - `symbol` string
    - `contentURI` string
    - `contentType` string
    - `contentBody` string
    - `contentPreviewURI` string
    - `sat` number
    - `satName` string
    - `satRarity` string
    - `genesisTransaction` string
    - `genesisTransactionBlockTime` string
    - `genesisTransactionBlockHeight` number
    - `genesisTransactionBlockHash` string
    - `inscriptionNumber` number
    - `meta` object
      - `name` string
      - `attributes` object[]
        - `trait_type` string
        - `value` string
    - `owner` string
    - `collectionSymbol` string
    - `location` string
    - `locationBlockHeight` number
    - `locationBlockTime` string
    - `locationBlockHash` string
    - `outputValue` number
    - `output` string
    - `mempoolTxId` string
    - `mempoolTxTimestamp` string
    - `listed` boolean
    - `listedAt` string
    - `listedPrice` number
    - `listedMakerFeeBp` number
    - `listedSellerReceiverAddress` string
    - `listedForMint` boolean
    - `brc20TransferAmt` number
    - `brc20ListedUnitPrice` number
    - `domain` string
    - `rareSatsUtxo` RareSatsUtxoSchema
      - `id` string
      - `txId` string
      - `vout` number
      - `value` number
      - `address` string
      - `blockInfo` BlockInfoSchema
        - `blockHash` string
        - `blockHeight` number
        - `blockTime` string
      - `listedPrice` 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
      - `hasUninscribedRareSat` boolean
      - `floorValue` number
  - `total` integer, required
  - `nextOffset` 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)