Order fill status

The fill status of an order indicates the proportion of the order that has been filled. It's expressed as a ratio comprised of a numerator and a denominator.

Orders containing ERC1155 tokens can be partially filled. The fill_status field in the order_updated event payload or in the get_order(s) response will indicate the ratio of the order that is currently filled. If the order has not been filled at all, the numerator and denominator values of the fill_status field will be 0. If the order has been fully filled, the numerator and denominator values will be equal.

Example #1 the below snipped would indicate that 50% of the order has been filled.

"fill_status": {
  "numerator": "1",
  "denominator": "2"
}

Example #2 the below snipped would indicate that 25% of the order has been filled.

"fill_status": {
  "numerator": "1",
  "denominator": "4"
}

Orders containing ERC721 tokens can only have a single asset and therefore only be fully filled so the numerator and denominator values in the fill_status will be 1 to indicate that the order has been fully filled.

Example #3 the below snipped would indicate that 100% of the order has been filled.

"fill_status": {
  "numerator": "1",
  "denominator": "1"
}