Desarrolladores

API para suministradores

Un endpoint. Publique un array de precios y reciba lo que se publicó y lo que se retuvo. No hay SDK que instalar ni integración sobre la que agendar una llamada — si su sistema ya tiene las cifras de hoy, esto es una sola petición HTTP.

Obtenga una clave

Abra el portal del suministrador con la dirección desde la que cotiza su mesa. El enlace que llega le inicia la sesión, y su clave está en esa página. Las claves empiezan por bfps_ y nunca caducan; puede rotar una desde la misma página.

Trátela como una contraseña. Cualquiera que la posea puede publicar precios en su nombre, y un precio erróneo atribuido a usted es peor para usted que para nosotros.

Publicar precios

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

Campos

Campo	Tipo		Notas
port	string	required	UN/LOCODE, cinco letras — SGSIN, NLRTM, AEFJR. No el nombre del puerto. Un código desconocido se rechaza solo para esa fila; el resto se publican igualmente.
grade	enum	required	VLSFO · HSFO · MGO · ULSFO · LNG · B24 · B30
amount	number	required	El precio, en la moneda y unidad indicadas abajo.
currency	USD \| EUR	optional	Por defecto USD. EUR se convierte al tipo de referencia en vivo del BCE del día.
unit	mt \| litre \| m3	optional	Por defecto mt. Las cifras por litro se convierten usando la densidad del grado.
basis	delivered \| ex_wharf \| fob	optional	Por defecto delivered. Esto importa: un precio ex-wharf mostrado como delivered subestima lo que paga un comprador, y solo comparamos dentro de un mismo basis.
minMt	number	optional	Partida mínima a la que se aplica el precio.
validHours	1–168	optional	Cuánto tiempo se mantiene. Por defecto 24, tras lo cual se marca como caducado en lugar de mostrarse como vigente.
taxIncluded	boolean	optional	Por defecto false. Relevante sobre todo para atraques de yates.

Respuesta

{
  "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 fila muy alejada del mercado en otros puertos se retiene para una persona en lugar de publicarse. Eso no es una duda sobre usted — es lo que impide que una sola cifra mal tecleada se convierta en un número sobre el que un comprador actúa, y protege su nombre más que el nuestro. Los precios retenidos normalmente se liberan el mismo día.

Las filas son independientes. Una fila errónea no rechaza el lote.

Consulte lo que tenemos

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

Devuelve sus últimos cien envíos con su estado, de modo que pueda conciliar sin llevar su propio registro de lo que aceptamos.

El tablón de precios público

Abierto, sin clave, y útil para comprobar dónde se sitúa su precio frente al resto del mercado antes de publicarlo.

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

Errores y límites

Estado	Significado
200	Procesado. Compruebe results — un 200 no significa que se publicara cada fila.
400	El cuerpo no se pudo parsear. La respuesta nombra el campo.
401	Clave ausente, incorrecta o en pausa.

Hasta 200 precios por petición. Publique con la frecuencia que quiera — la mayoría de las mesas publican una vez por la mañana y de nuevo si el mercado se mueve. Volver a publicar el mismo puerto y grado sustituye el precio anterior en lugar de duplicarlo.

Qué hacemos con ello

Su precio aparece en la página del puerto como indicativo, atribuido a su empresa, con la fecha. Los compradores que miran ese puerto ven su nombre junto a una cifra en lugar de un espacio en blanco, y las solicitudes de cotización llegan a usted en lugar de pasar de largo.

No somos suministrador de combustible, trader ni bróker y no mantenemos ninguna posición en ningún cargamento, así que no tenemos ningún interés en su precio salvo acertar con él. Todo el detalle en la Política de Datos y Precios. Retírelo en cualquier momento desde el portal, o escriba a data@bunkerfuelprices.com.