Feeding (v2)

Legacy feeding routes surface specific feed rate (SFR) benchmarks by region or by country. Both endpoints require a farmer-authenticated token (auth_is_farmer) and accept the optional exclude_self flag to remove the requesting farmer from benchmark calculations.

GET /v2/feeding/sfr-by-region-and-temperature

Returns SFR distributions grouped by AquaCloud region and temperature bucket.

Query parameters

Name	Type	Default	Notes
exclude_self	boolean	false	When true, removes the authenticated farmer’s data from the benchmark calculations.

Response fields (data[])

Field	Type	Description
region	string	AquaCloud region name.
weight_group	integer	Weight bucket index.
weight_bucket_name	string	Human-readable range (e.g. 0-500).
weight_bucket_start / weight_bucket_end	integer	Inclusive bucket boundaries in grams (nullable when not supplied).
species	string	Species code represented in the benchmark.
temperature	number	Bucket temperature (°C).
avg_sfr	number	Average specific feed rate (rounded to four decimals).
median_sfr	number	Median specific feed rate.
num_of_measurements	integer	Total measurements used in the bucket (nullable for sparse buckets).
highest_10_percent_avg_sfr	number	Average SFR for the top 10% of observations.
lowest_10_percent_avg_sfr	number	Average SFR for the bottom 10% of observations.
avg_temperature	number	Average ambient temperature across the bucket.

meta.time records when the response was generated.

Example

curl -X GET "https://api.aquacloud.ai/v2/feeding/sfr-by-region-and-temperature?exclude_self=true" \
  -H "Authorization: Bearer $TOKEN" \
  -H "x-client-secret: $CLIENT_SECRET"

GET /v2/feeding/sfr-by-country-and-temperature

Matches the same response shape as the regional endpoint but aggregates results at the country level. Use it when you need national benchmarks instead of regional groupings.

Parameters and response fields mirror those described above (without the region column).