신선 과방과 팜원유 가격 비교

FFB 가격은 가공 전 가격입니다

팜유 FFB 가격표는 특정 지역과 유효 기간에 대해 발표된 신선한 팜 열매 송이의 가격을 명시합니다. 가격표는 생산자 계약 형태와 수령에 따라 달라질 수 있습니다.

Narwhal 응답은 시장 범위, 킬로그램당 IDR 단위, 발표일, 적용일, 수정본 및 모든 수령별 행을 함께 유지합니다.

CPO는 가공 후 가격이 책정됩니다

CPO는 신선한 팜 열매 송이를 가공하여 생산합니다. CPO 기준 가격, 거래소 계약 또는 가공 공장 호가는 공식 FFB 구매 가격표와는 다른 상품과 시장을 나타냅니다.

Narwhal은 인도네시아 정부의 CPO 기준 가격과 말레이시아의 현지 인도 조건 CPO 평균 가격을 FFB와 별도 시계열로 제공합니다. 말레이시아 FFB 기준 가격은 톤당 가격이 아니라 팜유 추출률 1%당 MYR로 표시됩니다.

하나의 가격표에 담긴 여러 수령별 가격

담당 기관은 수령 구간별로 별도의 가격을 발표할 수 있습니다. 해당 행들은 하나의 가격 결정에 속하며 독립적인 시계열이 아닙니다.

누락되었거나 모호한 행이 있으면 전체 가격표가 거부됩니다. 수정본은 전체 가격표를 대체합니다.

날짜를 있는 그대로 읽기

period_start와 period_end는 관측값에 대해 승인된 기간을 나타냅니다. 인도네시아 유효 기간은 시작일과 종료일을 모두 포함합니다. 말레이시아 일일 관측값은 보고일부터 다음 날까지로 표시하되, 종료일인 다음 날은 포함하지 않습니다. 과거 데이터는 완전한 관측값을 오래된 순서로 정렬합니다.

최신 가격표 요청

먼저 승인된 시계열을 검색한 다음 반환된 series_id를 요청하세요. 국가와 지역은 검색 필터이며 시계열 ID를 대신할 수 없습니다. Narwhal API 키로 사용할 수 있습니다.

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/palmoil/physical/id-ri-oil-palm-ffb-smallholder-purchase-agreement" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

시계열을 선택하기 전에 검색하기

검색 응답은 상품, 국가, 지역, 단위, 생산자 계약 형태 및 적용 범위와 함께 고정된 series_id 값을 반환합니다. 이후 요청에서 가격의 의미가 알림 없이 바뀌지 않도록 선택한 series_id를 이 필드들과 함께 저장하세요.

이력을 조회할 때는 같은 series_id, 날짜 범위, limit를 유지하고 반환된 next_cursor를 다음 요청의 cursor로 전달하세요. 발행 자료가 철회되면 503 physical_price_unavailable이 반환되므로 계열을 다시 검색하세요. 형식이 잘못되거나 요청 조건과 맞지 않는 커서는 400 invalid_cursor를 반환합니다. 발행 자료가 변경되면 409 cursor_expired를 반환합니다. 인근 지역이나 다른 상품을 선택하지 말고 커서 없이 처음부터 다시 조회하세요.

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/palmoil/physical?product=ffb&country=IDN&area=ID-RI&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"