واجهة 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 هو مدى ثقة المحلّل (parser) حين قرأ بريد المورد. وتحت 0.9 يكون شخص قد راجعه.

لوحة الأسعار العامة

مفتوحة، لا تحتاج مفتاحًا ولا خطة.

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

الأخطاء