데이터 API

접근

포함됨: Fleet, Enterprise 및 Fleet. 키를 발급하는 곳: 설정; 키는 다음으로 시작합니다 bfp_.

키는 어떤 플랜에서도 발급될 수 있으며 다음을 반환합니다 402 플랜에 포함될 때까지 — 따라서 연동은 한 번 구축되고 플랜이 변경될 때 작동하기 시작하며, 변경될 때까지 차단되지 않습니다. Fleet은 월 50,000회 호출, Enterprise는 500,000회입니다.

귀사의 선단

GET https://bunkerfuelprices.com/api/v1/data/fleet

curl https://bunkerfuelprices.com/api/v1/data/fleet \
  -H "Authorization: Bearer bfp_YOUR_KEY"

{
  "organisation": "Aegean Shipping",
  "vessels": [
    {
      "imo": "9876543", "name": "MV EXAMPLE", "segment": "commercial",
      "dwt": 82000, "consumptionMtPerDay": 28.5, "serviceSpeedKts": 13.2,
      "scrubber": false,
      "position": {
        "lat": 1.265, "lon": 103.82, "speedKts": 11.4, "courseDeg": 87,
        "destination": "SGSIN",
        "nextPort": { "name": "Singapore", "locode": "SGSIN" },
        "etaAt": "2026-09-02T06:00:00.000Z",
        "observedAt": "2026-08-30T13:31:00.000Z", "source": "aisstream"
      },
      "rob": { "vlsfoMt": 640, "mgoMt": 95 }
    }
  ]
}

rob 은 잔존 재고(remaining on board) — 실제로 얼마나 급유할 수 있는지 결정하는 수치이며, 대부분의 선단 시스템이 선장에게 문의해야 하는 수치입니다.

요청 및 견적

GET https://bunkerfuelprices.com/api/v1/data/quotes?days=90

{
  "requests": [
    {
      "ref": "BFP-7K2M",
      "port": { "name": "Singapore", "locode": "SGSIN" },
      "grade": "VLSFO", "quantityMt": 1200,
      "status": "comparing",
      "quotes": [
        {
          "usdPerMt": 784.50,
          "allInUsdPerMt": 799.10,
          "bargeFeeUsd": 8500,
          "paymentTermDays": 30,
          "creditAdjUsdPerMt": 2.10,
          "basis": "delivered", "validUntil": "2026-08-30T17:00:00.000Z",
          "extractionConfidence": 0.96
        }
      ]
    }
  ]
}

allInUsdPerMt 이 비교 기준으로 삼아야 할 값입니다. 표시된 대표 수치는 귀사가 지불하는 금액이 아닙니다: 바지선 비용, 결제 조건 비용, 그리고 해당 공급업체와의 신용 포지션이 제외되며, 이 둘 사이의 격차는 통상적으로 톤당 $10에서 $40입니다. 공급업체를 다음으로 정렬하면 usdPerMt 신뢰할 수 있게 잘못된 공급업체를 고릅니다.

extractionConfidence 은 파서가 공급업체의 이메일을 읽었을 때 얼마나 확신했는지를 나타냅니다. 0.9 미만이면 사람이 검토했습니다.

공개 가격 보드

공개되어 있고, 키가 필요 없으며, 플랜이 필요 없습니다.

curl "https://bunkerfuelprices.com/api/v1/prices?grade=VLSFO&limit=50"

오류