commit b415771493c8256df6525704214b3489ba220992
parent 894a72cd0f5d7397f5b453d7a86795dea5307480
Author: Christian Grothoff <christian@grothoff.org>
Date: Sat, 21 Feb 2026 23:07:30 +0100
clarify max_age
Diffstat:
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/core/merchant/get-private-orders.rst b/core/merchant/get-private-orders.rst
@@ -12,7 +12,7 @@
:query delta: *Optional*. takes value of the form ``N (-N)``, so that at most ``N`` values strictly older (younger) than ``start`` and ``date_s`` are returned. Defaults to ``-20`` to return the last 20 entries (before ``start`` and/or ``date_s``). Deprecated in protocol **v12**. Use *limit* instead.
:query limit: *Optional*. At most return the given number of results. Negative for descending by row ID, positive for ascending by row ID. Default is ``20``. Since protocol **v12**.
:query date_s: *Optional.* Non-negative date in seconds after the UNIX Epoc. Only return orders created after the specified timestamp.
- :query max_age: *Optional.* Relative time. Only return orders younger than the specified age. Since protocol **v27**.
+ :query max_age: *Optional.* Relative time. Only return orders younger than the specified age. Only applicable if *delta* is positive. If both *max_age* and *date_s* are given, the larger of the two applies. Since protocol **v27**.
:query start: *Optional*. Row number threshold, see ``limit`` for its interpretation. Defaults to ``INT64_MAX``, namely the biggest row id possible in the database. Deprecated in protocol **v12**. Use *offset* instead.
:query offset: *Optional*. Starting ``row_id`` for an iteration. Since protocol **v12**.
:query timeout_ms: *Optional*. Timeout in milliseconds to wait for additional orders if the answer would otherwise be negative (long polling). Only useful if ``limit`` is positive. Note that the merchant MAY still return a response that contains fewer than ``limit`` orders.
