{"uid":"cap_6bbAG5-W5Qg7wlSS03yeq","slug":"halowerk-agri-fertilizer-map-58df2d68","name":"Halowerk Agri Fertilizer Map","description":"For each field cell, subtracts measured available nutrient from a supplied target and divides positive deficits by an explicit recovery fraction. It reports per-hectare rates and area totals. It does not infer crop targets, validate laboratory samples, account for nutrient chemistry or constitute an agronomic application prescription.","url":"https://agri.halowerk.com/v1/fertilizer-map","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cells":{"type":"array","items":{"type":"object","required":["cell_id","area_hectares","available_kg_per_ha","target_kg_per_ha"],"properties":{"cell_id":{"type":"string","maxLength":128,"minLength":1},"area_hectares":{"type":"number","maximum":1000000,"minimum":0.0001},"target_kg_per_ha":{"type":"object","required":["nitrogen","phosphorus","potassium"],"properties":{"nitrogen":{"type":"number","maximum":100000,"minimum":0},"potassium":{"type":"number","maximum":100000,"minimum":0},"phosphorus":{"type":"number","maximum":100000,"minimum":0}},"additionalProperties":false},"available_kg_per_ha":{"type":"object","required":["nitrogen","phosphorus","potassium"],"properties":{"nitrogen":{"type":"number","maximum":100000,"minimum":0},"potassium":{"type":"number","maximum":100000,"minimum":0},"phosphorus":{"type":"number","maximum":100000,"minimum":0}},"additionalProperties":false}},"additionalProperties":false},"maxItems":10000,"minItems":1},"recovery_fraction":{"type":"object","required":["nitrogen","phosphorus","potassium"],"properties":{"nitrogen":{"type":"number","maximum":1,"minimum":0.01},"potassium":{"type":"number","maximum":1,"minimum":0.01},"phosphorus":{"type":"number","maximum":1,"minimum":0.01}},"additionalProperties":false},"maximum_rate_kg_per_ha":{"type":"object","required":["nitrogen","phosphorus","potassium"],"properties":{"nitrogen":{"type":"number","maximum":100000,"minimum":0},"potassium":{"type":"number","maximum":100000,"minimum":0},"phosphorus":{"type":"number","maximum":100000,"minimum":0}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BwxZDN1Ko-aktvJhzEPYH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes per-cell fertilizer application rates (N, P, K) by subtracting available soil nutrients from caller-supplied targets and dividing deficits by recovery fractions, returning per-hectare rates and area totals for each field cell.","exampleAgentPrompt":"For my 3 field zones — zone A (5 ha, available N=40, P=12, K=80 kg/ha), zone B (8 ha, available N=55, P=18, K=90 kg/ha), and zone C (3.5 ha, available N=30, P=8, K=70 kg/ha) — all with target N=120, P=40, K=150 kg/ha and recovery fractions of N=0.6, P=0.8, K=0.7, calculate the fertilizer rates I need to apply per hectare and the total kg needed for each zone.","exampleUseCases":[{"title":"Variable-rate map from soil tests","prompt":"I've got soil test results for 5 paddocks — each has measured available N, P and K in kg/ha — and I want to hit target levels of N=150, P=50, K=120 kg/ha. With recovery fractions of 0.65 for nitrogen, 0.85 for phosphorus and 0.75 for potassium, can you work out how much fertilizer each paddock needs per hectare and in total? Paddock sizes are 10, 7.5, 12, 4, and 6.2 hectares."},{"title":"Nitrogen-only deficit check with rate cap","prompt":"My field has 20 cells from the last soil scan. Each cell is 0.5 ha with target nitrogen of 180 kg/ha and a recovery fraction of 0.6. I want a maximum application rate cap of 200 kg/ha for nitrogen. Can you compute the nitrogen application rate and total kg needed per cell given the available nitrogen readings I'll provide?"},{"title":"Season-start NPK planning for grain crop","prompt":"Before I place my fertilizer order I need to know the total tonnes of N, P and K I need across all 30 field zones. I have the area, current soil-available nutrient levels and my agronomist's targets for each zone. Recovery fractions are 0.7 for N, 0.8 for P, 0.75 for K. Can you compute the per-hectare rates and field-level totals so I can sum them up?"}],"resultDescription":"Returns an array of per-cell results containing the cell ID, computed fertilizer application rate in kg/ha for each of nitrogen, phosphorus and potassium (capped at any supplied maximum), the raw deficit before recovery adjustment, and the total kg of each nutrient required for the full cell area. May also include field-level aggregate totals across all cells.","failureModes":["Missing required nutrient keys (nitrogen, phosphorus, potassium) in any cell's available or target objects returns a validation error","Recovery fraction of zero or below minimum (0.01) causes rejection","Cell area outside valid range (below 0.0001 or above 1,000,000 ha) causes rejection","Submitting more than 10,000 cells in one request exceeds the array limit","Nutrient values exceeding 100,000 kg/ha are rejected","Payment not included or insufficient USDC triggers 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you have explicit soil-test nutrient availability values and agronomist-specified target levels per field cell and need a deterministic, arithmetic deficit-to-rate calculation with configurable recovery fractions and optional rate caps. It is not a crop-recommendation engine — prefer it when targets are already known and you need precise kg/ha quantities and area totals rather than agronomic advice or prescription generation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:35.283Z","isFirstParty":false}