LLM API Guide
Guía completa para obtener datos de USDT/BOB y utilizarlos en tus LLMs y aplicaciones.
🤖 Integración LLM - Este guía es para usar GET /api/llm.json directamente en tus LLMs. Si buscas documentación para integraciones de sistema más complejas, consulta API Documentation .
Get USDT/BOB Price Data
Endpoint:
curl https://dolaresabolivianos.com/api/llm.jsonEssential Fields for LLM Integration
| JSON Path | Description | Type |
|---|---|---|
currency_pair.exchange_rate.average | Current average price (primary metric) | number |
currency_pair.exchange_rate.best_buy_rate | Best buy price available | number |
currency_pair.exchange_rate.best_sell_rate | Best sell price available | number |
market_data.spread.percentage | Spread between buy/sell | number |
market_data.liquidity.total_usd | Total available liquidity | number |
market_data.bcb.buy_rate | Official BCB buy rate | number |
market_data.bcb.sell_rate | Official BCB sell rate | number |
metadata.updated_at | Last update timestamp | ISO 8601 |
Complete JSON Response Structure
{`{ "metadata": { "version": "1.1", "updated_at": "2026-03-06T00:25:09.000Z", "source": "DolaresABolivianos.com", "description": "Real-time USDT to BOB market data" }, "currency_pair": { "from": "USDT", "to": "BOB", "exchange_rate": { "average": 9.22, "median_buy": 9.25, "median_sell": 9.14, "best_buy_rate": 9.23, "best_sell_rate": 9.21, "low_buy": 9.23, "high_sell": 9.21 } }, "market_data": { "spread": { "absolute": -0.02, "percentage": -0.217 }, "liquidity": { "buy_usd": 605376, "sell_usd": 4515247, "total_usd": 5120623 }, "bcb": { "buy_rate": 8.85, "sell_rate": 9.04, "buy_liquidity_usd": 74623612, "note": "Values inverted in UI (compra<->venta)" } }, "raw_data": { "timestamp": 1772756709, "q50_buy": 9.25, "q50_sell": 9.14, "lower_whisker_buy": 9.23, "upper_whisker_sell": 9.21 }, "note": "Data updates every 30 seconds. Timestamp in Unix epoch." }`}Quick Access Examples
Get average price (for LLM prompts):
curl -s https://www.dolaresabolivianos.com/api/llm.json | jq '.currency_pair.exchange_rate.average'Get all exchange rates:
curl -s https://www.dolaresabolivianos.com/api/llm.json | jq '.currency_pair.exchange_rate'Get market data (liquidity + spread):
curl -s https://www.dolaresabolivianos.com/api/llm.json | jq '.market_data'⚡ Update Frequency
Every 30 seconds
Los datos se actualizan cada 30 segundos desde múltiples fuentes P2P.
⚠️ Important Notes
- ✓ Primary field: Use `currency_pair.exchange_rate.average` as your main price value
- ✓ Whisker values: `lower_whisker_buy` and `upper_whisker_sell` = statistical bounds from market data
- ✓ Medians: `median_buy` (Q50) and `median_sell` (Q50) = 50th percentile prices
- ⚠️ BCB values: Are inverted in UI labels (compra ↔ venta) due to bank perspective vs user perspective
- ⚠️ Liquidity: P2P liquidity (buy_usd + sell_usd) vs BCB (buy_liquidity_usd) are from different markets
- ✓ Updates: Data refreshes every 30 seconds. Use timestamp for freshness checks
💡 LLM Integration Examples
Python - Get current price for LLM context:
{`import requests import json response = requests.get('https://www.dolaresabolivianos.com/api/llm.json') data = response.json() # Format for LLM context price_context = f""" Current USDT to BOB Exchange Rate (as of {data['metadata']['updated_at']}): - Average: {data['currency_pair']['exchange_rate']['average']} Bs - Can buy at: {data['currency_pair']['exchange_rate']['best_buy_rate']} Bs - Can sell at: {data['currency_pair']['exchange_rate']['best_sell_rate']} Bs - Liquidity: ${data['market_data']['liquidity']['total_usd']:,} USD - Market Spread: {data['market_data']['spread']['percentage']:.2f}% Official BCB Rates: - Buy (Official): {data['market_data']['bcb']['buy_rate']} Bs - Sell (Official): {data['market_data']['bcb']['sell_rate']} Bs """ # Pass to LLM print(price_context)`}Using in LLM prompts:
{`# Example prompt for GPT/Claude: f""" Today's USDT/BOB rate is {current_price} Bs. A user is asking about exchanging $100 USD to BOB. Using above rates, calculate and explain the transaction. Include P2P vs official rate differences. """ `}Mantén esta API gratuita y sin límites
Tu donación nos permite seguir ofreciendo datos actualizados sin restricciones de uso