Sviluppatori

API fornitori

Un endpoint. Pubblica un array di prezzi, ricevi indietro cosa è stato pubblicato e cosa è stato trattenuto. Non c'è alcun SDK da installare né alcuna integrazione per cui pianificare una call — se il tuo sistema ha già i numeri di oggi, questa è una sola richiesta HTTP.

Ottieni una chiave

Apri il portale fornitori con l'indirizzo da cui il tuo desk quota. Il link che ricevi ti fa accedere, e la tua chiave si trova su quella pagina. Le chiavi iniziano con bfps_ e non scadono mai; puoi ruotarne una dalla stessa pagina.

Trattala come una password. Chiunque la possieda può pubblicare prezzi a tuo nome, e un prezzo errato attribuito a te è peggio per te che per noi.

Pubblica i prezzi

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" }
    ]
  }'

Campi

Campo	Tipo		Note
port	string	required	UN/LOCODE, cinque lettere — SGSIN, NLRTM, AEFJR. Non il nome del porto. Un codice sconosciuto viene rifiutato solo per quella riga; le altre vengono comunque pubblicate.
grade	enum	required	VLSFO · HSFO · MGO · ULSFO · LNG · B24 · B30
amount	number	required	Il prezzo, nella valuta e nell'unità indicate sotto.
currency	USD \| EUR	optional	Predefinito USD. EUR viene convertito al tasso di riferimento ECB del giorno.
unit	mt \| litre \| m3	optional	Predefinito mt. Le cifre per litro vengono convertite usando la densità del grade.
basis	delivered \| ex_wharf \| fob	optional	Predefinito delivered. Questo è importante: un prezzo ex-wharf mostrato come delivered sottostima quanto paga un acquirente, e noi confrontiamo solo all'interno di una stessa basis.
minMt	number	optional	Parcel minimo a cui si applica il prezzo.
validHours	1–168	optional	Per quanto tempo resta valido. Predefinito 24, dopo le quali viene contrassegnato come obsoleto anziché mostrato come attuale.
taxIncluded	boolean	optional	Predefinito false. Rilevante soprattutto per gli ormeggi di yacht.

Risposta

{
  "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"] }
  ]
}

Una riga distante dal mercato negli altri porti viene trattenuta per una persona anziché pubblicata. Non è un dubbio su di te — è ciò che impedisce a un numero digitato male di diventare una cifra su cui un acquirente agisce, e protegge il tuo nome più del nostro. I prezzi trattenuti vengono normalmente rilasciati in giornata.

Le righe sono indipendenti. Una riga errata non fa rifiutare il batch.

Rileggi cosa abbiamo

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

Restituisce le tue ultime cento submission con il relativo stato, così puoi riconciliare senza tenere un tuo registro di cosa abbiamo accettato.

Il price board pubblico

Aperto, senza chiave, e utile per verificare dove si colloca il tuo prezzo rispetto al resto del mercato prima di pubblicarlo.

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

Errori e limiti

Stato	Significato
200	Elaborato. Controlla results — un 200 non significa che ogni riga sia stata pubblicata.
400	Il body non è stato interpretato. La risposta indica il campo.
401	Chiave mancante, errata o sospesa.

Fino a 200 prezzi per richiesta. Pubblica con la frequenza che preferisci — la maggior parte dei desk pubblica una volta al mattino e di nuovo se il mercato si muove. Ripubblicare lo stesso porto e grade sostituisce il prezzo precedente anziché duplicarlo.

Cosa ne facciamo

Il tuo prezzo appare sulla pagina del porto come indicativo, attribuito alla tua azienda, con la data. Gli acquirenti che consultano quel porto vedono il tuo nome accanto a un numero anziché uno spazio vuoto, e le richieste di quotazione raggiungono te anziché passarti accanto.

Non siamo un fornitore di carburante, un trader o un broker e non deteniamo alcuna posizione di trading su nessun carico, quindi non abbiamo alcun interesse nel tuo prezzo se non avere ragione al riguardo. Tutti i dettagli nella Data & Pricing Policy. Ritira in qualsiasi momento dal portale, oppure scrivi a data@bunkerfuelprices.com.