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"
}