Sign in

v1

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

Get user's bid Orders

Returns bid Orders created by specified user and sorted by last update date

get/v0.1/orders/bids/byMaker

Query parameters

makerUnionAddress[] required

Since user's address can be present in several blockchains (for example, ETHEREUM and POLYGON), you can use this filter to get Orders only for specific blockchains. Or keep it empty to get Order from all blockchains

[
  "ETHEREUM:0x4765273c477c2dc484da4f1984639e943adccfeb"
]
blockchainsBlockchain[]

Names of the blockchain networks. If no one specified, data from all blockchains will be returned

[
  "ETHEREUM"
]
platform'RARIBLE' | 'OPEN_SEA' | 'CRYPTO_PUNKS' | 'IMMUTABLEX' | 'HEN' | 'OBJKT' | 'VERSUM' | 'TEIA' | 'OTHER' | 'FXHASH'

The platform where the order was created

collectionCollectionId[]

The nft collection of order

[
  "ETHEREUM:0xb66a603f4cfe17e3d27b87a8bfcad319856518b8"
]
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"
          }
        ]
      }
    }
  ]
}