Immutable Orders API

The orders API from Immutable — 14 operation(s) for orders.

Operations 19

POST /v1/chains/{chain_name}/orders/cancel Cancel one or more orders #
GET /v1/chains/{chain_name}/orders/listings List all listings #
POST /v1/chains/{chain_name}/orders/listings Create a listing #
GET /v1/chains/{chain_name}/orders/bids List all bids #
POST /v1/chains/{chain_name}/orders/bids Create a bid #
GET /v1/chains/{chain_name}/orders/collection-bids List all collection bids #
POST /v1/chains/{chain_name}/orders/collection-bids Create a collection bid #
GET /v1/chains/{chain_name}/orders/trait-bids List all trait bids #
POST /v1/chains/{chain_name}/orders/trait-bids Create a trait bid #
GET /v1/chains/{chain_name}/orders/metadata-bids List all metadata bids #
POST /v1/chains/{chain_name}/orders/metadata-bids Create a metadata bid #
GET /v1/chains/{chain_name}/orders/trait-bids/{trait_bid_id} Get a single trait bid by ID #
GET /v1/chains/{chain_name}/orders/metadata-bids/{metadata_bid_id} Get a single metadata bid by ID #
GET /v1/chains/{chain_name}/orders/listings/{listing_id} Get a single listing by ID #
GET /v1/chains/{chain_name}/orders/bids/{bid_id} Get a single bid by ID #
GET /v1/chains/{chain_name}/orders/collection-bids/{collection_bid_id} Get a single collection bid by ID #
POST /v1/chains/{chain_name}/orders/fulfillment-data Retrieve fulfillment data for orders #
GET /v1/chains/{chain_name}/trades List all trades #
GET /v1/chains/{chain_name}/trades/{trade_id} Get a single trade by ID #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/immutable-orders-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

immutable-orders-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Immutable zkEVM Orders API
  version: 1.0.0
  description: Immutable Multi Rollup API
  contact:
    name: Immutable API Support
    email: support@immutable.com
    url: https://support.immutable.com
servers:
- url: https://api.sandbox.immutable.com
tags:
- name: orders
  x-displayName: orders
paths:
  /v1/chains/{chain_name}/orders/cancel:
    post:
      tags:
      - orders
      summary: Cancel one or more orders
      description: Cancel one or more orders
      operationId: CancelOrders
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CancelOrdersRequestBody'
      responses:
        '200':
          description: Orders cancellation response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancelOrdersResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/UnauthorisedRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '501':
          $ref: '#/components/responses/NotImplementedError'
  /v1/chains/{chain_name}/orders/listings:
    get:
      tags:
      - orders
      summary: List all listings
      description: List all listings
      operationId: ListListings
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      - name: status
        in: query
        description: Order status to filter by
        required: false
        schema:
          $ref: '#/components/schemas/OrderStatusName'
      - name: sell_item_contract_address
        in: query
        description: Sell item contract address to filter by
        required: false
        schema:
          type: string
          example: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: buy_item_type
        in: query
        description: Buy item type to filter by
        required: false
        schema:
          type: string
          enum:
          - NATIVE
          - ERC20
          example: NATIVE
      - name: buy_item_contract_address
        in: query
        description: Buy item contract address to filter by
        required: false
        schema:
          type: string
          example: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: account_address
        in: query
        description: The account address of the user who created the listing
        required: false
        schema:
          type: string
          example: '0xc49Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: sell_item_metadata_id
        in: query
        description: The metadata_id of the sell item
        required: false
        schema:
          type: string
          format: uuid
          example: 020792C9-4AD7-8EC4-4038-9E05C598535B
      - name: sell_item_token_id
        in: query
        description: Sell item token identifier to filter by
        required: false
        schema:
          type: string
          example: '1'
          pattern: \d+
      - name: from_updated_at
        in: query
        description: From updated at including given date
        required: false
        schema:
          type: string
          format: date-time
          example: '2022-03-09T05:00:50.52Z'
      - name: page_size
        in: query
        description: Maximum number of orders to return per page
        schema:
          $ref: '#/components/schemas/PageSize'
      - name: sort_by
        in: query
        description: Order field to sort by. `buy_item_amount` sorts by per token price, for example if 5 ERC-1155s are on sale for 10eth, it’s sorted as 2eth for `buy_item_amount`.
        required: false
        schema:
          type: string
          enum:
          - created_at
          - updated_at
          - buy_item_amount
          description: Order field to sort by
          example: created_at
        example: created_at
      - name: sort_direction
        in: query
        description: Ascending or descending direction for sort
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          description: Ascending or descending direction for sort
          example: asc
        example: asc
      - name: page_cursor
        in: query
        description: Page cursor to retrieve previous or next page. Use the value returned in the response.
        required: false
        schema:
          $ref: '#/components/schemas/PageCursor'
      responses:
        '200':
          description: OK response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListListingsResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
    post:
      tags:
      - orders
      summary: Create a listing
      description: Create a listing
      operationId: CreateListing
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateListingRequestBody'
      responses:
        '201':
          description: Created response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListingResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/GatewayTimeout'
  /v1/chains/{chain_name}/orders/bids:
    get:
      tags:
      - orders
      summary: List all bids
      description: List all bids
      operationId: ListBids
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      - name: status
        in: query
        description: Order status to filter by
        required: false
        schema:
          $ref: '#/components/schemas/OrderStatusName'
      - name: buy_item_contract_address
        in: query
        description: Buy item contract address to filter by
        required: false
        schema:
          type: string
          example: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: sell_item_contract_address
        in: query
        description: Sell item contract address to filter by
        required: false
        schema:
          type: string
          example: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: account_address
        in: query
        description: The account address of the user who created the bid
        required: false
        schema:
          type: string
          example: '0xc49Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: buy_item_metadata_id
        in: query
        description: The metadata_id of the buy item
        required: false
        schema:
          type: string
          format: uuid
          example: 020792C9-4AD7-8EC4-4038-9E05C598535B
      - name: buy_item_token_id
        in: query
        description: buy item token identifier to filter by
        required: false
        schema:
          type: string
          example: '1'
          pattern: \d+
      - name: from_updated_at
        in: query
        description: From updated at including given date
        required: false
        schema:
          type: string
          format: date-time
          example: '2022-03-09T05:00:50.52Z'
      - name: page_size
        in: query
        description: Maximum number of orders to return per page
        schema:
          $ref: '#/components/schemas/PageSize'
      - name: sort_by
        in: query
        description: Order field to sort by. `sell_item_amount` sorts by per token price, for example if 10eth is offered for 5 ERC1155 items, it’s sorted as 2eth for `sell_item_amount`.
        required: false
        schema:
          type: string
          enum:
          - created_at
          - updated_at
          - sell_item_amount
          description: Order field to sort by
          example: created_at
        example: created_at
      - name: sort_direction
        in: query
        description: Ascending or descending direction for sort
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          description: Ascending or descending direction for sort
          example: asc
        example: asc
      - name: page_cursor
        in: query
        description: Page cursor to retrieve previous or next page. Use the value returned in the response.
        required: false
        schema:
          $ref: '#/components/schemas/PageCursor'
      responses:
        '200':
          description: OK response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListBidsResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
    post:
      tags:
      - orders
      summary: Create a bid
      description: Create a bid
      operationId: CreateBid
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateBidRequestBody'
      responses:
        '201':
          description: Created response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BidResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '501':
          $ref: '#/components/responses/NotImplementedError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/GatewayTimeout'
  /v1/chains/{chain_name}/orders/collection-bids:
    get:
      tags:
      - orders
      summary: List all collection bids
      description: List all collection bids
      operationId: ListCollectionBids
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      - name: status
        in: query
        description: Order status to filter by
        required: false
        schema:
          $ref: '#/components/schemas/OrderStatusName'
      - name: buy_item_contract_address
        in: query
        description: Buy item contract address to filter by
        required: false
        schema:
          type: string
          example: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: sell_item_contract_address
        in: query
        description: Sell item contract address to filter by
        required: false
        schema:
          type: string
          example: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: account_address
        in: query
        description: The account address of the user who created the bid
        required: false
        schema:
          type: string
          example: '0xc49Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: from_updated_at
        in: query
        description: From updated at including given date
        required: false
        schema:
          type: string
          format: date-time
          example: '2022-03-09T05:00:50.52Z'
      - name: page_size
        in: query
        description: Maximum number of orders to return per page
        schema:
          $ref: '#/components/schemas/PageSize'
      - name: sort_by
        in: query
        description: Order field to sort by. `sell_item_amount` sorts by per token price, for example if 10eth is offered for 5 ERC1155 items, it’s sorted as 2eth for `sell_item_amount`.
        required: false
        schema:
          type: string
          enum:
          - created_at
          - updated_at
          - sell_item_amount
          description: Order field to sort by
          example: created_at
        example: created_at
      - name: sort_direction
        in: query
        description: Ascending or descending direction for sort
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          description: Ascending or descending direction for sort
          example: asc
        example: asc
      - name: page_cursor
        in: query
        description: Page cursor to retrieve previous or next page. Use the value returned in the response.
        required: false
        schema:
          $ref: '#/components/schemas/PageCursor'
      responses:
        '200':
          description: OK response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListCollectionBidsResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
    post:
      tags:
      - orders
      summary: Create a collection bid
      description: Create a collection bid
      operationId: CreateCollectionBid
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCollectionBidRequestBody'
      responses:
        '201':
          description: Created response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectionBidResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '501':
          $ref: '#/components/responses/NotImplementedError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/GatewayTimeout'
  /v1/chains/{chain_name}/orders/trait-bids:
    get:
      tags:
      - orders
      summary: List all trait bids
      description: List all trait bids
      operationId: ListTraitBids
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      - name: status
        in: query
        description: Order status to filter by
        required: false
        schema:
          $ref: '#/components/schemas/OrderStatusName'
      - name: buy_item_contract_address
        in: query
        description: Buy item contract address to filter by
        required: false
        schema:
          type: string
          example: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: sell_item_contract_address
        in: query
        description: Sell item contract address to filter by
        required: false
        schema:
          type: string
          example: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: account_address
        in: query
        description: The account address of the user who created the bid
        required: false
        schema:
          type: string
          example: '0xc49Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: from_updated_at
        in: query
        description: From updated at including given date
        required: false
        schema:
          type: string
          format: date-time
          example: '2022-03-09T05:00:50.52Z'
      - name: page_size
        in: query
        description: Maximum number of orders to return per page
        schema:
          $ref: '#/components/schemas/PageSize'
      - name: sort_by
        in: query
        description: Order field to sort by. `sell_item_amount` sorts by per token price, for example if 10eth is offered for 5 ERC1155 items, it’s sorted as 2eth for `sell_item_amount`.
        required: false
        schema:
          type: string
          enum:
          - created_at
          - updated_at
          - sell_item_amount
          description: Order field to sort by
          example: created_at
        example: created_at
      - name: sort_direction
        in: query
        description: Ascending or descending direction for sort
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          description: Ascending or descending direction for sort
          example: asc
        example: asc
      - name: page_cursor
        in: query
        description: Page cursor to retrieve previous or next page. Use the value returned in the response.
        required: false
        schema:
          $ref: '#/components/schemas/PageCursor'
      responses:
        '200':
          description: OK response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListTraitBidsResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
    post:
      tags:
      - orders
      summary: Create a trait bid
      description: Create a trait bid on NFTs matching specific trait criteria within a collection
      operationId: CreateTraitBid
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateTraitBidRequestBody'
      responses:
        '201':
          description: Created response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TraitBidResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '501':
          $ref: '#/components/responses/NotImplementedError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/GatewayTimeout'
  /v1/chains/{chain_name}/orders/metadata-bids:
    get:
      tags:
      - orders
      summary: List all metadata bids
      description: List all metadata bids
      operationId: ListMetadataBids
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      - name: status
        in: query
        description: Order status to filter by
        required: false
        schema:
          $ref: '#/components/schemas/OrderStatusName'
      - name: buy_item_contract_address
        in: query
        description: Buy item contract address to filter by
        required: false
        schema:
          type: string
          example: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: sell_item_contract_address
        in: query
        description: Sell item contract address to filter by
        required: false
        schema:
          type: string
          example: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: account_address
        in: query
        description: The account address of the user who created the bid
        required: false
        schema:
          type: string
          example: '0xc49Fd6e51aad88F6F4ce6aB8827279cffFb92266'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: from_updated_at
        in: query
        description: From updated at including given date
        required: false
        schema:
          type: string
          format: date-time
          example: '2022-03-09T05:00:50.52Z'
      - name: page_size
        in: query
        description: Maximum number of orders to return per page
        schema:
          $ref: '#/components/schemas/PageSize'
      - name: sort_by
        in: query
        description: Order field to sort by. `sell_item_amount` sorts by per token price, for example if 10eth is offered for 5 ERC1155 items, it’s sorted as 2eth for `sell_item_amount`.
        required: false
        schema:
          type: string
          enum:
          - created_at
          - updated_at
          - sell_item_amount
          description: Order field to sort by
          example: created_at
        example: created_at
      - name: sort_direction
        in: query
        description: Ascending or descending direction for sort
        required: false
        schema:
          type: string
          enum:
          - asc
          - desc
          description: Ascending or descending direction for sort
          example: asc
        example: asc
      - name: page_cursor
        in: query
        description: Page cursor to retrieve previous or next page. Use the value returned in the response.
        required: false
        schema:
          $ref: '#/components/schemas/PageCursor'
      responses:
        '200':
          description: OK response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListMetadataBidsResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
    post:
      tags:
      - orders
      summary: Create a metadata bid
      description: Create a metadata bid on NFTs matching a specific metadata identifier within a collection
      operationId: CreateMetadataBid
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateMetadataBidRequestBody'
      responses:
        '201':
          description: Created response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MetadataBidResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '501':
          $ref: '#/components/responses/NotImplementedError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/GatewayTimeout'
  /v1/chains/{chain_name}/orders/trait-bids/{trait_bid_id}:
    get:
      tags:
      - orders
      summary: Get a single trait bid by ID
      description: Get a single trait bid by ID
      operationId: GetTraitBid
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      - name: trait_bid_id
        in: path
        description: Global Trait Bid identifier
        required: true
        schema:
          type: string
          format: uuid
          description: Global Trait Bid identifier
          example: 018792C9-4AD7-8EC4-4038-9E05C598534A
      responses:
        '200':
          description: OK response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TraitBidResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /v1/chains/{chain_name}/orders/metadata-bids/{metadata_bid_id}:
    get:
      tags:
      - orders
      summary: Get a single metadata bid by ID
      description: Get a single metadata bid by ID
      operationId: GetMetadataBid
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      - name: metadata_bid_id
        in: path
        description: Global Metadata Bid identifier
        required: true
        schema:
          type: string
          format: uuid
          description: Global Metadata Bid identifier
          example: 018792C9-4AD7-8EC4-4038-9E05C598534A
      responses:
        '200':
          description: OK response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MetadataBidResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /v1/chains/{chain_name}/orders/listings/{listing_id}:
    get:
      tags:
      - orders
      summary: Get a single listing by ID
      description: Get a single listing by ID
      operationId: GetListing
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      - name: listing_id
        in: path
        description: Global Order identifier
        required: true
        schema:
          type: string
          format: uuid
          description: Global Order identifier
          example: 018792C9-4AD7-8EC4-4038-9E05C598534A
      responses:
        '200':
          description: OK response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListingResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /v1/chains/{chain_name}/orders/bids/{bid_id}:
    get:
      tags:
      - orders
      summary: Get a single bid by ID
      description: Get a single bid by ID
      operationId: GetBid
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      - name: bid_id
        in: path
        description: Global Bid identifier
        required: true
        schema:
          type: string
          format: uuid
          description: Global Bid identifier
          example: 018792C9-4AD7-8EC4-4038-9E05C598534A
      responses:
        '200':
          description: OK response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BidResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /v1/chains/{chain_name}/orders/collection-bids/{collection_bid_id}:
    get:
      tags:
      - orders
      summary: Get a single collection bid by ID
      description: Get a single collection bid by ID
      operationId: GetCollectionBid
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      - name: collection_bid_id
        in: path
        description: Global Collection Bid identifier
        required: true
        schema:
          type: string
          format: uuid
          description: Global Collection Bid identifier
          example: 018792C9-4AD7-8EC4-4038-9E05C598534A
      responses:
        '200':
          description: OK response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectionBidResult'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
  /v1/chains/{chain_name}/orders/fulfillment-data:
    post:
      tags:
      - orders
      summary: Retrieve fulfillment data for orders
      description: Retrieve signed fulfillment data based on the list of order IDs and corresponding fees.
      operationId: fulfillment_data
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/FulfillmentDataRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: object
                    properties:
                      fulfillable_orders:
                        type: array
                        items:
                          $ref: '#/components/schemas/FulfillableOrder'
                      unfulfillable_orders:
                        type: array
                        items:
                          $ref: '#/components/schemas/UnfulfillableOrder'
                    required:
                    - fulfillable_orders
                    - unfulfillable_orders
                required:
                - result
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
        '504':
          $ref: '#/components/responses/GatewayTimeout'
  /v1/chains/{chain_name}/trades:
    get:
      tags:
      - orders
      summary: List all trades
      description: List all trades
      operationId: ListTrades
      x-public: true
      parameters:
      - name: chain_name
        in: path
        required: true
        schema:
          $ref: '#/components/schemas/ChainName'
      - name: account_address
        in: query
        required: false
        schema:
          type: string
          description: Account address to filter trades by (includes buy and sell wallet address)
          example: '0x784578949A4A50DeA641Fb15dd2B11C72E76919a'
          pattern: ^0x[a-fA-F0-9]{40}$
      - name: sell_item_contract_address
        in: query
        required: false
      

# --- truncated at 32 KB (106 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/immutable/refs/heads/main/openapi/immutable-orders-api-openapi.yml