数据 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 即船上余量——决定您实际能加多少油的数字，也是多数船队系统不得不向船长询问的那个数字。

询价与报价

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"

错误