Commodities API reference
Palmoil FFB schedules and history
Base URL
REST base path
https://api.narwhalapi.com/v1/commodities- Every request will use the same Narwhal Bearer key and shared account quota.
- REST and MCP use the same input and output schemas.
- Inputs and outputs use the same code-owned schemas.
Three physical-price operations
| Operation | REST path | MCP tool |
|---|---|---|
| Discover physical-price series | /v1/commodities/physical/{commodity}/{country} | commodities_discover_physical_series |
| Get latest Palmoil FFB schedule | /v1/commodities/oil-palm-ffb-price | commodities_get_oil_palm_ffb_price |
| Get Palmoil FFB schedule history | /v1/commodities/oil-palm-ffb-price/observations | commodities_get_oil_palm_ffb_price_observations |
Shared behavior
- Physical-series discovery returns only complete, rights-approved series.
- One Palmoil FFB response is one whole official purchase schedule.
- Tree-age rows cannot be published or revised independently.
- History is oldest-first and uses opaque filter-bound cursors.
- Missing, overlapping, ambiguous, or mixed-rights schedules fail closed.
- Rejected or unavailable requests do not consume monthly quota.
First-release scope
The first slice is official Indonesian Palmoil fresh-fruit-bunch purchase schedules. It is not a CPO benchmark, futures price, generic farmgate average, mill quote, or trading signal.
Riau is the first current Adapter. Other researched areas retain historical, acceptance-only, or extraction-gated status. Read Commodities coverage and the methodology for the exact limits.
Palmoil API access is not open yet.