---
title: "Get tokens"
method: GET
path: "/v2/ord/btc/tokens"
tags: ["Tokens"]
---

# Get tokens

`GET /v2/ord/btc/tokens`

Get tokens, can be filtered by collectionSymbol, owner, tokenIds

## Query parameters

- `tokenIds` string
- `collectionSymbol` string
- `ownerAddress` string
- `showAll` boolean
- `limit` integer
- `offset` integer
- `inscriptionMin` number
- `inscriptionMax` number
- `sortBy` 'priceAsc' | 'priceDesc' | 'listedAtAsc' | 'listedAtDesc' | 'inscriptionNumberAsc' | 'inscriptionNumberDesc' | 'brc20UnitPriceAsc' | 'brc20UnitPriceDesc'
- `minPrice` number
- `maxPrice` number
- `satRarity` 'common' | 'uncommon' | 'rare' | 'epic' | 'legendary' | 'mythic'

## Response `200`

Successful response

- object
  - `total` integer
  - `items` ItemSchema[]
    - `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

---

[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/versions/66028b292693/schema)