---
title: "Get collection offer wall"
method: GET
path: "/openapi/v1/collection/bids"
tags: ["Collection"]
---

# Get collection offer wall

`GET /openapi/v1/collection/bids`

This endpoint can be used to get collection offer wall from the system.

## Query parameters

- `chain` 'eth' | 'bsc' | 'polygon' | 'avalanche' | 'arbitrum' | 'zksync' | 'linea' | 'starknet' | 'opbnb' | 'base' | 'scroll' | 'manta_pacific' | 'optimism' | 'mantle' | 'zkfair' | 'blast' | 'merlin' | 'mode' | 'cyber' | 'bob' | 'lightlink' | 'zeta' | 'nibiru' | 'abstract' | 'bitlayer' | 'mantra' | 'monad' | 'ink', required
- `contract_address` string, required
- `trait` string
- `precision` string
- `viewer_address` string

## Response `200`

OK

- ApiResponseCollectionOfferWallVO
  - `code` integer — Error Code
  - `msg` string — Error Message
  - `data` CollectionOfferWallVO — Return data, Generic
    - `curPrecision` number — Current accuracy.
    - `minPrecision` number — Minimum accuracy.
    - `wallData` CollectionOfferWallDataVO[] — Wall data list.
      - `price` string — The current offer price.
      - `numberOrders` integer — Current precision order quantity.
      - `numberNfts` integer — Current precision purchase quantity.
      - `viewerOffered` integer — Whether the viewer has made an offer, 0 means no, 1 means yes.
      - `numberMakers` integer — The number of makers for the current precision order.
      - `markets` string[] — Which markets the orders come from.
      - `makerAddresses` string[] — The current precision maker list. If there is only one maker, it returns string data. If there are more than one maker, it returns empty.
      - `paymentToken` string — The currency address of the offer.
      - `priceSource` string — Cumulative amount in the original currency of the order.
      - `priceBase` string — The cumulative amount of the order in the current chain base currency.
      - `paymentTokenCoin` PaymentTokenCoinVO — Currency information of the offer.
        - `name` string
        - `address` string
        - `icon` string
        - `decimal` integer
        - `accuracy` integer
  - `message` string

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/element/apis/element-open-api.md) · [All operations](https://skmtc.net/element/apis/element-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/element/element-open-api/revisions/fa83ac7feb23/schema)