---
title: "Get listings for a token"
method: GET
path: "/tokens/{token_mint}/listings"
tags: ["tokens"]
---

# Get listings for a token

`GET /tokens/{token_mint}/listings`

## Path parameters

- `token_mint` string, required

## Query parameters

- `listingAggMode` boolean

## Response `200`

success response

- SwaggerFriendlyIListingV2[]
  - `price` number, double, required
  - `tokenAddress` string, required
  - `pdaAddress` string, required
  - `auctionHouse` string, required
  - `tokenMint` string, required
  - `seller` string, required
  - `sellerReferral` string
  - `tokenSize` number, double, required
  - `rarity` NFTRarity, required
    - `howrare` object
      - `rank` number, double, required
    - `moonrank` object
      - `crawl` MoonrankCrawl, required
        - `complete` boolean — Flag for if Moonrank has fully crawled the collection. If this is false, then it means the rarity values are incomplete and should not be used.
        - `id` string
      - `absolute_rarity` number, double, required
      - `rank` number, double, required
    - `merarity` MeTokenRarity
      - `tokenKey` string, required
      - `score` number, double, required
      - `rank` number, double
      - `totalSupply` number, double
      - `attributeWithCounts` IXAttribute[]
        - `traitType` string, required
        - `value` string, required
        - `count` number, double
        - `rarity` number, double
        - `topBidValue` number, double
        - `floorAskPrice` number, double
        - `onSaleCount` number, double
    - `meInstant` MeInstantRarity
      - `rank` number, double, required
  - `extra` IExtraPublicInfo
    - `img` string
  - `expiry` number, double, required
  - `listingSource` 'M2' | 'MMM' | 'TENSOR_LISTING' | 'TENSOR_CNFT_LISTING' | 'TENSOR_MARKETPLACE_LISTING' | 'TENSOR_AMM' | 'TENSOR_AMM_V2' | 'HADESWAP_AMM' | 'M3', required
  - `priceInfo` SwaggerFriendlyPriceInfo
    - `solPrice` SwaggerFriendlyTokenAmount, required
      - `rawAmount` string, required
      - `address` string, required — The identifier of the amount.
      - `decimals` number, double, required — The number of decimals in the amount.
    - `splPrice` SwaggerFriendlyTokenAmount
      - `rawAmount` string, required
      - `address` string, required — The identifier of the amount.
      - `decimals` number, double, required — The number of decimals in the amount.
  - `token` SwaggerFriendlyITokenV2, required
    - `mintAddress` string, required
    - `owner` string, required
    - `supply` number, double, required
    - `delegate` string
    - `collection` string
    - `collectionName` string
    - `name` string, required
    - `updateAuthority` string, required
    - `primarySaleHappened` boolean, required
    - `sellerFeeBasisPoints` number, double, required
    - `image` string, required
    - `tokenStandard` 0 | 1 | 2 | 3 | 4 | 5 | -1
    - `animationUrl` string
    - `externalUrl` string
    - `attributes` IAttributeV2[]
      - `trait_type` string, required
      - `value` unknown, required
    - `properties` IPropertiesV2
      - `files` IPropertiesV2File[], required
        - `uri` string, required
        - `type` string, required
        - `cdn` boolean
      - `category` string, required
      - `creators` PartialICreatorV2[], required
        - `address` string
        - `verified` boolean
        - `share` number, double
    - `listStatus` 'listed' | 'unlisted'
    - `price` number, double
    - `tokenAddress` string
    - `isCompressed` boolean
    - `priceInfo` SwaggerFriendlyPriceInfo
      - `solPrice` SwaggerFriendlyTokenAmount, required
        - `rawAmount` string, required
        - `address` string, required — The identifier of the amount.
        - `decimals` number, double, required — The number of decimals in the amount.
      - `splPrice` SwaggerFriendlyTokenAmount
        - `rawAmount` string, required
        - `address` string, required — The identifier of the amount.
        - `decimals` number, double, required — The number of decimals in the amount.

## Other responses

- `400` — Token not found

---

[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)