GET /exchange-rate — Tipo de Cambio - CUCU API

curl "https://crypto.cucu.ai/api/v1/exchange-rate?fiat=BOB&crypto=USDT"

const response = await fetch(
  'https://crypto.cucu.ai/api/v1/exchange-rate?fiat=BOB&crypto=USDT'
);
const data = await response.json();

import requests

response = requests.get(
    'https://crypto.cucu.ai/api/v1/exchange-rate',
    params={'fiat': 'BOB', 'crypto': 'USDT'}
)
print(response.json())

{
  "fiat": "BOB",
  "crypto": "USDT",
  "sell": {
    "median": 6.97,
    "top": 6.98,
    "min": 6.95,
    "max": 7.01,
    "ads_count": 12,
    "fetched_at": 1737815400,
    "source": "binance_p2p"
  },
  "buy": {
    "median": 6.94,
    "top": 6.93,
    "min": 6.90,
    "max": 6.96,
    "ads_count": 9,
    "fetched_at": 1737815400,
    "source": "binance_p2p"
  },
  "spread": 0.03,
  "source": "binance_p2p"
}

{
  "detail": "Upstream market data unavailable"
}

GET

/

api

/

v1

/

exchange-rate

curl "https://crypto.cucu.ai/api/v1/exchange-rate?fiat=BOB&crypto=USDT"

const response = await fetch(
  'https://crypto.cucu.ai/api/v1/exchange-rate?fiat=BOB&crypto=USDT'
);
const data = await response.json();

import requests

response = requests.get(
    'https://crypto.cucu.ai/api/v1/exchange-rate',
    params={'fiat': 'BOB', 'crypto': 'USDT'}
)
print(response.json())

{
  "fiat": "BOB",
  "crypto": "USDT",
  "sell": {
    "median": 6.97,
    "top": 6.98,
    "min": 6.95,
    "max": 7.01,
    "ads_count": 12,
    "fetched_at": 1737815400,
    "source": "binance_p2p"
  },
  "buy": {
    "median": 6.94,
    "top": 6.93,
    "min": 6.90,
    "max": 6.96,
    "ads_count": 9,
    "fetched_at": 1737815400,
    "source": "binance_p2p"
  },
  "spread": 0.03,
  "source": "binance_p2p"
}

{
  "detail": "Upstream market data unavailable"
}

Endpoint público — no requiere API Key. Devuelve el snapshot SELL + BUY del mercado P2P para un par fiat/crypto. Cache de 60 segundos.

Query Params

Parámetro	Tipo	Default	Descripción
`fiat`	string	`BOB`	Código ISO de moneda fiat: `BOB`, `USD`, `ARS`, `PEN`, `BRL`, `CLP`, `MXN`, `COP`.
`crypto`	string	`USDT`	Símbolo del activo crypto: `USDT`, `USDC`, etc.

Response

Campo	Tipo	Descripción
`fiat`	string	Moneda fiat consultada.
`crypto`	string	Activo crypto consultado.
`sell.median`	float	Precio mediano de venta. Usar este valor para conversiones de display.
`sell.top`	float	Mejor precio de venta listado en el mercado.
`sell.min`	float	Precio mínimo de venta.
`sell.max`	float	Precio máximo de venta.
`sell.ads_count`	int	Número de anuncios activos.
`sell.fetched_at`	int	UNIX timestamp de la consulta al mercado.
`buy.median`	float	Precio mediano de compra.
`spread`	float	`median(sell) − median(buy)`. Positivo en condiciones normales.
`source`	string	Fuente de datos. Actualmente `binance_p2p`.

Anti-stale guarantee: si el upstream no está disponible, el endpoint devuelve 503 Service Unavailable. Nunca devuelve un valor desactualizado en silencio.

curl "https://crypto.cucu.ai/api/v1/exchange-rate?fiat=BOB&crypto=USDT"

const response = await fetch(
  'https://crypto.cucu.ai/api/v1/exchange-rate?fiat=BOB&crypto=USDT'
);
const data = await response.json();

import requests

response = requests.get(
    'https://crypto.cucu.ai/api/v1/exchange-rate',
    params={'fiat': 'BOB', 'crypto': 'USDT'}
)
print(response.json())

{
  "fiat": "BOB",
  "crypto": "USDT",
  "sell": {
    "median": 6.97,
    "top": 6.98,
    "min": 6.95,
    "max": 7.01,
    "ads_count": 12,
    "fetched_at": 1737815400,
    "source": "binance_p2p"
  },
  "buy": {
    "median": 6.94,
    "top": 6.93,
    "min": 6.90,
    "max": 6.96,
    "ads_count": 9,
    "fetched_at": 1737815400,
    "source": "binance_p2p"
  },
  "spread": 0.03,
  "source": "binance_p2p"
}

{
  "detail": "Upstream market data unavailable"
}