diff --git a/website/source/api/query.html.md b/website/source/api/query.html.md index 586244fcf7..28441f710f 100644 --- a/website/source/api/query.html.md +++ b/website/source/api/query.html.md @@ -177,8 +177,12 @@ The table below shows this endpoint's support for nodes in the response will be sorted in ascending order of estimated round-trip times. If the node given does not exist, the nodes in the response will be shuffled. Using `_agent` is supported, and will automatically return - results nearest the agent servicing the request. If unspecified, the response - will be shuffled by default. + results nearest the agent servicing the request. Using `_ip` is supported and + will automatically return results nearest to the node associated with the + source IP where the query is executed from. For HTTP the source IP is remote + peers IP address or the value of the X-Forwarded-For head with the header + taking precedence. For DNS the source IP is the value of the EDNS client IP. + If unspecified, the response will be shuffled by default. - `Service` `(Service: )` - Specifies the structure to define the query's behavior. @@ -474,7 +478,9 @@ Token will be used. - `near` `(string: "")` - Specifies to sort the resulting list in ascending order based on the estimated round trip time from that node. Passing - `?near=_agent` will use the agent's node for the sort. If this is not present, + `?near=_agent` will use the agent's node for the sort. Passing `?near=_ip` + will use the source IP of the request or the value of the X-Forwarded-For + header to lookup the node to use for the sort. If this is not present, the default behavior will shuffle the nodes randomly each time the query is executed.