---
title: "Get batch listings of a collection"
method: POST
path: "/collections/batch/listings"
tags: ["collections"]
---

# Get batch listings of a collection

`POST /collections/batch/listings`

## Query parameters

- `offset` integer
- `limit` integer
- `min_price` number
- `max_price` number
- `attributes` array[]
  - SwaggerNftAttribute[]
    - `traitType` string, required
    - `value` string, required
- `sort` 'updatedAt' | 'listPrice'
- `sort_direction` 'asc' | 'desc'
- `listingAggMode` boolean

## Response `200`

success response

- BatchListings[]
  - `result` SwaggerFriendlyIListingV2[], required
    - `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.
  - `nextCursor` string, required

## Other responses

- `400` — Invalid symbol

---

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