Développeurs

API fournisseur

Un seul endpoint. Publiez un tableau de prix, recevez en retour ce qui a été publié et ce qui a été mis en attente. Aucun SDK à installer ni intégration nécessitant de planifier une réunion — si votre système a déjà les chiffres du jour, il s'agit d'une seule requête HTTP.

Obtenir une clé

Ouvrez le portail fournisseur avec l'adresse depuis laquelle votre desk cote. Le lien reçu vous connecte, et votre clé se trouve sur cette page. Les clés commencent par bfps_ et n'expirent jamais ; vous pouvez en effectuer la rotation depuis la même page.

Traitez-la comme un mot de passe. Quiconque la détient peut publier des prix en votre nom, et un prix erroné attribué à votre société est pire pour vous que pour nous.

Publier des prix

POST https://bunkerfuelprices.com/api/v1/supplier/prices

curl -X POST https://bunkerfuelprices.com/api/v1/supplier/prices \
  -H "Authorization: Bearer bfps_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prices": [
      { "port": "SGSIN", "grade": "VLSFO", "amount": 784.50 },
      { "port": "SGSIN", "grade": "MGO",   "amount": 1146.00 },
      { "port": "AEFJR", "grade": "VLSFO", "amount": 795.00,
        "minMt": 200, "validHours": 24, "basis": "delivered" }
    ]
  }'

Champs

Champ	Type		Notes
port	string	required	UN/LOCODE, cinq lettres — SGSIN, NLRTM, AEFJR. Pas le nom du port. Un code inconnu est rejeté pour cette ligne uniquement ; les autres sont tout de même publiées.
grade	enum	required	VLSFO · HSFO · MGO · ULSFO · LNG · B24 · B30
amount	number	required	Le prix, dans la devise et l'unité ci-dessous.
currency	USD \| EUR	optional	USD par défaut. L'EUR est converti au taux de référence BCE du jour.
unit	mt \| litre \| m3	optional	Par défaut mt. Les chiffres par litre sont convertis en utilisant la densité du grade.
basis	delivered \| ex_wharf \| fob	optional	Par défaut delivered. Cela compte : un prix ex-wharf présenté comme livré sous-estime ce que paie l'acheteur, et nous ne comparons qu'au sein d'un même basis.
minMt	number	optional	Lot minimum auquel le prix s'applique.
validHours	1–168	optional	Durée de validité. 24 par défaut, après quoi il est marqué comme périmé plutôt qu'affiché comme actuel.
taxIncluded	boolean	optional	false par défaut. Pertinent principalement pour les postes d'amarrage de yachts.

Réponse

{
  "accepted": 3,
  "published": 2,
  "held": 1,
  "results": [
    { "port": "SGSIN", "grade": "VLSFO", "ok": true, "published": true,
      "submissionId": "..." },
    { "port": "SGSIN", "grade": "MGO",   "ok": true, "published": true,
      "submissionId": "..." },
    { "port": "AEFJR", "grade": "VLSFO", "ok": true, "published": false,
      "heldForReview": ["38% away from the $795 median across 6 other ports"] }
  ]
}

Une ligne très éloignée du marché constaté dans d'autres ports est mise en attente pour examen par une personne plutôt que publiée. Ce n'est pas de la défiance à votre égard — c'est ce qui empêche un chiffre mal saisi de devenir une valeur sur laquelle un acheteur se fonde, et cela protège votre nom plus que le nôtre. Les prix mis en attente sont normalement débloqués le jour même.

Les lignes sont indépendantes. Une ligne erronée ne fait pas rejeter le lot.

Relire ce que nous détenons

curl https://bunkerfuelprices.com/api/v1/supplier/prices \
  -H "Authorization: Bearer bfps_YOUR_KEY"

Renvoie vos cent dernières soumissions avec leur statut, afin que vous puissiez faire le rapprochement sans tenir votre propre journal de ce que nous avons accepté.

Le tableau public des prix

Ouvert, sans clé requise, et utile pour vérifier où se situe votre prix par rapport au reste du marché avant de le publier.

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

Erreurs et limites

Statut	Signification
200	Traité. Vérifiez results — un 200 ne signifie pas que toutes les lignes ont été publiées.
400	Le corps n'a pas pu être analysé. La réponse indique le champ concerné.
401	Clé manquante, incorrecte ou suspendue.

Jusqu'à 200 prix par requête. Publiez aussi souvent que vous le souhaitez — la plupart des desks publient une fois le matin, puis à nouveau si le marché bouge. Republier le même port et le même grade remplace le prix précédent au lieu de le dupliquer.

Ce que nous en faisons

Votre prix apparaît sur la page du port à titre indicatif, au nom de votre société, avec la date. Les acheteurs qui consultent ce port voient votre nom à côté d'un chiffre plutôt qu'un espace vide, et les demandes d'offre vous parviennent au lieu de vous échapper.

Nous ne sommes ni fournisseur de carburant, ni trader, ni courtier, et ne détenons aucune position de trading sur une cargaison, de sorte que nous n'avons aucun intérêt dans votre prix, si ce n'est qu'il soit juste. Détail complet dans la Politique de données et de tarification. Retirez-le à tout moment depuis le portail, ou écrivez à data@bunkerfuelprices.com.