Developer API

API Specifications

• ✓ No Authentication Required: Fully public, rate-limited free tier designed for global developers.
• ✓ Format: All payloads returned in lightweight, clean standardized JSON format.
• ✓ Rate Limit: 60 req/min/IP
• ✓ Required Backlink: Public display requires hyperlink to buonmathuotcoffee.com as data source.

Get Current Spot & Futures prices

Retrieve the latest continuous front-month settlement pricing for ICE Robusta, ICE Arabica, Dak Lak farm-gate index, premium differentials, and spot USD/VND rate.

{
  "status": "success",
  "data": {
    "timestamp": "2026-05-20T04:54:14Z",
    "usd_vnd": 26084.00,
    "ice_robusta": {
      "value": 3386.50,
      "change": 2.10,
      "change_pct": 0.06
    },
    "ice_arabica": {
      "value": 3.13,
      "change": 0.01,
      "change_pct": 0.32
    },
    "vietnam_farmgate": {
      "value": 83355.00,
      "usd_equivalent": 3195.60,
      "change": -87.00,
      "change_pct": -0.10
    },
    "differential": {
      "value": -190.90,
      "change": -89.10
    }
  }
}

Get Historical Price Dataset

Query daily closing prices since January 1, 2026. Perfect for building line charts, statistical dashboards, and machine learning models.

Quick Integration Snippets

curl -X GET "https://buonmathuotcoffee.com/api/v1/coffee-price"

import requests

url = "https://buonmathuotcoffee.com/api/v1/coffee-price"
response = requests.get(url)
data = response.json()

print(f"Robusta Price: ${data['data']['ice_robusta']['value']} USD/Tonne")

const axios = require('axios');

axios.get('https://buonmathuotcoffee.com/api/v1/coffee-price')
  .then(response => {
    console.log(`Robusta Price: $${response.data.data.ice_robusta.value} USD`);
  });

<?php

$url = "https://buonmathuotcoffee.com/api/v1/coffee-price";
$response = file_get_contents($url);
$data = json_decode($response, true);

echo "Robusta Price: $" . $data['data']['ice_robusta']['value'] . " USD\n";