---
updatedAt: 2026-06-22T07:09:27.000Z
agentTools:
projectIndex: https://element.readme.io/llms.txt
---
# Get collection offer wall
This endpoint can be used to get collection offer wall from the system.
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Element Open API",
"description": "OpenAPI 3.0 based swagger docs for Element Public API.If you have questions, Please review HelpCenter for help, Or Contact Us.",
"contact": {
"name": "Element",
"url": "https://element.market/",
"email": ""
},
"version": "1.0.0"
},
"servers": [
{
"url": "https://api.element.market",
"description": "Mainnet API"
}
],
"security": [
{
"X-Api-Key": []
}
],
"tags": [
{
"name": "Collection"
}
],
"paths": {
"/openapi/v1/collection/bids": {
"get": {
"tags": [
"Collection"
],
"summary": "Get collection offer wall",
"description": "This endpoint can be used to get collection offer wall from the system.",
"operationId": "collectionBids",
"parameters": [
{
"name": "chain",
"in": "query",
"description": "Chain Name",
"required": true,
"schema": {
"type": "string",
"enum": [
"eth",
"bsc",
"polygon",
"arbitrum",
"zksync",
"linea",
"starknet",
"opbnb",
"base",
"manta_pacific",
"mantle",
"zkfair",
"merlin",
"mode",
"cyber",
"bob",
"lightlink",
"zeta",
"nibiru",
"bitlayer",
"mantra",
"monad",
"ink",
"robinhood"
]
},
"example": "eth"
},
{
"name": "contract_address",
"in": "query",
"description": "The smart contract address.",
"required": true,
"schema": {
"type": "string"
},
"example": "0x67405cadb820c2d89b8d6da3e42ef6a39089c831"
},
{
"name": "trait",
"in": "query",
"description": "Filter by trait.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "precision",
"in": "query",
"description": "Filter by precision.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "viewer_address",
"in": "query",
"description": "Filter by viewer address.",
"required": false,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiResponseCollectionOfferWallVO"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BadRequestErrorResponse"
}
}
}
},
"429": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TooManyRequestsErrorResponse"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InternalServerErrorResponse"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"BadRequestErrorResponse": {
"type": "object",
"properties": {
"status": {
"type": "integer",
"format": "int32",
"example": 400
},
"error": {
"type": "string",
"example": "Bad Request"
},
"message": {
"type": "string",
"example": "Missing Header: X-api-key"
},
"path": {
"type": "string",
"example": "/openapi/v1/orders/list"
}
}
},
"TooManyRequestsErrorResponse": {
"type": "object",
"properties": {
"status": {
"type": "integer",
"format": "int32",
"example": 429
},
"error": {
"type": "string",
"example": "Too Many Requests"
},
"message": {
"type": "string",
"example": "You have exhausted your API Request Quota"
},
"path": {
"type": "string",
"example": "/openapi/v1/orders/list"
}
}
},
"InternalServerErrorResponse": {
"type": "object",
"properties": {
"status": {
"type": "integer",
"format": "int32",
"example": 500
},
"error": {
"type": "string",
"example": "Internal server error"
}
}
},
"PaymentTokenCoinVO": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"address": {
"type": "string"
},
"icon": {
"type": "string"
},
"decimal": {
"type": "integer",
"format": "int32"
},
"accuracy": {
"type": "integer",
"format": "int32"
}
},
"description": "Currency information of the offer."
},
"ApiResponseCollectionOfferWallVO": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"description": "Error Code",
"format": "int32"
},
"msg": {
"type": "string",
"description": "Error Message"
},
"data": {
"$ref": "#/components/schemas/CollectionOfferWallVO"
},
"message": {
"type": "string",
"writeOnly": true
}
}
},
"CollectionOfferWallDataVO": {
"type": "object",
"properties": {
"price": {
"type": "string",
"description": "The current offer price."
},
"numberOrders": {
"type": "integer",
"description": "Current precision order quantity.",
"format": "int32"
},
"numberNfts": {
"type": "integer",
"description": "Current precision purchase quantity.",
"format": "int64"
},
"viewerOffered": {
"type": "integer",
"description": "Whether the viewer has made an offer, 0 means no, 1 means yes.",
"format": "int32"
},
"numberMakers": {
"type": "integer",
"description": "The number of makers for the current precision order.",
"format": "int32"
},
"markets": {
"type": "array",
"description": "Which markets the orders come from.",
"items": {
"type": "string",
"description": "Which markets the orders come from."
}
},
"makerAddresses": {
"type": "array",
"description": "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.",
"items": {
"type": "string",
"description": "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": {
"type": "string",
"description": "The currency address of the offer."
},
"priceSource": {
"type": "string",
"description": "Cumulative amount in the original currency of the order."
},
"priceBase": {
"type": "string",
"description": "The cumulative amount of the order in the current chain base currency."
},
"paymentTokenCoin": {
"$ref": "#/components/schemas/PaymentTokenCoinVO"
}
},
"description": "Wall data list."
},
"CollectionOfferWallVO": {
"type": "object",
"properties": {
"curPrecision": {
"type": "number",
"description": "Current accuracy."
},
"minPrecision": {
"type": "number",
"description": "Minimum accuracy."
},
"wallData": {
"type": "array",
"description": "Wall data list.",
"items": {
"$ref": "#/components/schemas/CollectionOfferWallDataVO"
}
}
},
"description": "Return data, Generic"
}
},
"securitySchemes": {
"X-Api-Key": {
"type": "apiKey",
"name": "X-Api-Key",
"in": "header"
}
}
},
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true
}
}
```