---
title: "Submit Batch Listing"
method: POST
path: "/v2/ord/btc/raresats/listing"
tags: ["Rare Sats"]
---

# Submit Batch Listing

`POST /v2/ord/btc/raresats/listing`

## Request

- Base URL: `https://api-mainnet.magiceden.dev/v2`
- URL: `https://api-mainnet.magiceden.dev/v2/v2/ord/btc/raresats/listing`
- Auth: none declared
- TypeScript: <https://skmtc.dev/magiceden/apis/magic-eden-api/docs/v2/ord/btc/raresats/listing/post.ts> (a function with typed inputs; its response is checked against the schema)

Submit Batch Listing using the signed PSBT received from `GET /listing-psbt`

## Request body

- RareSatsListingRequestSchema
  - `listings` RareSatsListingSchema[], required
    - `sellerReceiveAddress` string, required
    - `price` number, required: The total price of the listed rare sats utxo. Must be equal to the sum of the price of each sat range
    - `utxoId` string, required
    - `satRangePrices` RareSatsSatRangePriceSchema[], required
      - `id` string, required
      - `from` number, required
      - `to` number, required
      - `parentFrom` number, required
      - `parentTo` number, required
      - `unitPrice` number
      - `satributes` SatributesSchema[], required
    - `signedListingPSBTBase64` string, required: Same as the signedCombinedPSBTBase64
    - `makerFee` number, required: Will be deprecated
    - `publicKey` string
  - `signedCombinedPSBTBase64` string, required: The selling PSBT must be signed by the rare sats owner. The unsigned PSBT can be generated using the `POST /listing-psbt` endpoint

## Response `200`

Successful response

- RareSatsListingResultSchema
  - `ok` boolean, required
  - `listed` number, required
  - `failed` string[], required

---

[API](https://skmtc.dev/magiceden/apis/magic-eden-api.md) - [All operations](https://skmtc.dev/magiceden/apis/magic-eden-api/llms.txt) - [OpenAPI document](https://skmtc.dev/magiceden/apis/magic-eden-api/revisions/66028b292693?raw)