Sign in

v1

latestOpenAPI 3.0.3raw.githubusercontent.com2025-06-1883262329.3 KB
NFT Sales

Get bid Orders for NFT

Returns bid Orders created for specified NFT and sorted by price in USD (expensive first)

get/v0.1/orders/bids/byItem

Query parameters

platform'RARIBLE' | 'OPEN_SEA' | 'CRYPTO_PUNKS' | 'IMMUTABLEX' | 'HEN' | 'OBJKT' | 'VERSUM' | 'TEIA' | 'OTHER' | 'FXHASH'

The platform where the order was created

itemIdstring required

Item Id, has format ETHEREUM:${token}:${tokenId}

Example:ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8:32292934596187112148346015918544186536963932779440027682601542850818403729410

Item Id, has format ETHEREUM:${token}:${tokenId}

makerUnionAddress[]

The maker of the bid

[
  "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
]
originstring

Blockchain address in Union format ${blockchainGroup}:${token}

Example:ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb

Address of the consumer to receive the commission for the order

statusOrderStatus[]

Order status

currenciesCurrencyId[]

Currencies for bids

[
  "ETHEREUM:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
]
startinteger

Lower time border of data (timestamp)

endinteger

Upper time border of data (timestamp)

continuationstring

Continuation token from the previous response

sizeinteger

The number of items to return

searchEngine'LEGACY' | 'V1'

Search engine to use for search

Response

OK

continuationstring

Continuation token to paginate orders search result

Example response

{
  "orders": [
    {
      "id": "ETHEREUM:0x19f487016770542dc6137b06499a4f7b42c9580f12d85d6347964b03b7682143",
      "maker": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb",
      "taker": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb",
      "make": {
        "type": {
          "blockchain": "ETHEREUM",
          "contract": "ETHEREUM:0xd07dc4262bcdbf85190c01c996b4c06a461d2430"
        }
      },
      "take": {
        "type": {
          "blockchain": "ETHEREUM",
          "contract": "ETHEREUM:0xd07dc4262bcdbf85190c01c996b4c06a461d2430"
        }
      },
      "feeTakers": [
        "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
      ],
      "data": {
        "payouts": [
          {
            "account": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
          }
        ],
        "originFees": [
          {
            "account": "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
          }
        ]
      }
    }
  ]
}