# Buda Exchange API > Live spot market data from Buda.com, a leading Latin American crypto exchange operating in Chile, Colombia and Peru, served straight from its public order books — no key on the data, nothing cached, nothing stored. Look up any market for its last price, best bid/ask and spread, 24h and 7d change and base/quote volume; rank every market for a quote currency (Chilean peso CLP, Colombian peso COP, Peruvian sol PEN, or BTC/USDC/USDT) by 24h turnover; list the tradable pairs with their base and quote; or pull live order-book depth with the running spread. Markets are addressed BASE-QUOTE (BTC-CLP). This is the Buda venue specifically — a distinct Latin-American price feed across three local currencies, ideal for CLP/COP/PEN price discovery and LatAm-market arbitrage, separate from the USD/USDT-quoted exchange APIs in the catalogue. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/buda-api/..." ``` ## Pricing - **Free** (Free) — 19,500 calls/Mo, 3 req/s - **Starter** ($8/Mo) — 265,000 calls/Mo, 10 req/s - **Growth** ($22/Mo) — 1,210,000 calls/Mo, 25 req/s - **Scale** ($52/Mo) — 4,300,000 calls/Mo, 50 req/s ## Endpoints ### Ticker #### `GET /v1/ticker` — Ticker for one market **Parameters:** - `market` (query, optional, string) — Market as BTC-CLP Example: `BTC-CLP` - `base` (query, optional, string) — Base asset (with quote=) Example: `ETH` - `quote` (query, optional, string) — Quote currency CLP/COP/PEN Example: `CLP` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/buda-api/v1/ticker?market=BTC-CLP&base=ETH"e=CLP" ``` **Response:** ```json { "data": { "ask": 57763218.9, "bid": 57178188, "base": "BTC", "last": 57800879.6, "quote": "CLP", "market": "BTC-CLP", "source": "Buda", "spread": 585030.9, "change_7d_pct": 0.3, "change_24h_pct": 1.9, "base_volume_24h": 3.34626687, "quote_volume_24h": 189955850.92 }, "meta": { "timestamp": "2026-06-11T07:48:25.850Z", "request_id": "d44239f0-d99c-4b61-9111-64ce68006c8e" }, "status": "ok", "message": "Ticker retrieved successfully", "success": true } ``` ### Tickers #### `GET /v1/tickers` — All markets for a quote ranked by 24h turnover **Parameters:** - `quote` (query, optional, string) — Quote currency CLP/COP/PEN Example: `CLP` - `limit` (query, optional, string) — Max results (1-400) Example: `50` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/buda-api/v1/tickers?quote=CLP&limit=50" ``` **Response:** ```json { "data": { "count": 7, "quote": "CLP", "source": "Buda", "tickers": [ { "ask": 919.84, "bid": 915.03, "base": "USDT", "last": 920, "quote": "CLP", "market": "USDT-CLP", "spread": 4.81, "change_7d_pct": 2.3, "change_24h_pct": 0, "base_volume_24h": 261820.990034, "quote_volume_24h": 239970403.97 }, { "ask": 57763218.9, "bid": 57178188, "base": "BTC", "last": 57800879.6, "quote": "CLP", "market": "BTC-CLP", "spread": 585030.9, "change_7d_pct": 0.3, "change_24h_pct": 1.9, "base_volume_24h": 3.34626687, "quote_volume_24h": 189955850.92 }, { "ask": 920.56, "bid": 919.41, "base": "USDC", "last": 920.62, "quote": "CLP", "market": "USDC-CLP", "spread": 1.15, "change_7d_pct": 2.4, "change_24h_pct": 0.4, "base_volume_24h": 188299.139571, "quote_volume_24h": 172715254.44 }, { "ask": 1523393.4, "bid": 1510617, …(truncated, see openapi.json for full schema) ``` ### Markets #### `GET /v1/markets` — Tradable pairs with base/quote **Parameters:** - `quote` (query, optional, string) — Filter by quote currency Example: `CLP` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/buda-api/v1/markets?quote=CLP" ``` **Response:** ```json { "data": { "count": 7, "quote": "CLP", "source": "Buda", "markets": [ { "base": "BCH", "quote": "CLP", "market": "BCH-CLP", "min_order": 0.001 }, { "base": "BTC", "quote": "CLP", "market": "BTC-CLP", "min_order": 2.0e-5 }, { "base": "ETH", "quote": "CLP", "market": "ETH-CLP", "min_order": 0.001 }, { "base": "LTC", "quote": "CLP", "market": "LTC-CLP", "min_order": 0.003 }, { "base": "SOL", "quote": "CLP", "market": "SOL-CLP", "min_order": 0.001 }, { "base": "USDC", "quote": "CLP", "market": "USDC-CLP", "min_order": 0.01 }, { "base": "USDT", "quote": "CLP", "market": "USDT-CLP", "min_order": 0.01 } ] }, "meta": { "timestamp": "2026-06-11T07:48:27.072Z", "request_id": "34137a2e-a66b-4302-b34d-e49c4a0ba551" }, "status": "ok", "message": "Markets retrieved successfully", "success": true } ``` ### Book #### `GET /v1/book` — Live order-book depth with running spread **Parameters:** - `market` (query, optional, string) — Market as BTC-CLP Example: `BTC-CLP` - `limit` (query, optional, string) — Depth per side (1-100) Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/buda-api/v1/book?market=BTC-CLP&limit=20" ``` **Response:** ```json { "data": { "asks": [ { "price": 57763008.9, "amount": 0.010199 }, { "price": 57763038.7, "amount": 0.127 }, { "price": 57763083.89, "amount": 0.00452204 }, { "price": 57822748.34, "amount": 0.0118456 }, { "price": 57988489, "amount": 0.15818764 }, { "price": 57990000, "amount": 0.01734266 }, { "price": 58000000, "amount": 0.03067188 }, { "price": 58236428, "amount": 0.23922 }, { "price": 58241429, "amount": 0.007636 }, { "price": 58241431, "amount": 0.0105285 }, { "price": 58787045, "amount": 0.147207 }, { "price": 58787046, "amount": 8.529e-5 }, { "price": 58799999, "amount": 0.147207 }, { "price": 58800000, "amount": 0.00163336 }, { "price": 58977730.3, …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/buda-api/v1/meta" ``` **Response:** ```json { "data": { "note": "Markets are BASE-QUOTE (BTC-CLP). The default quote is the Chilean peso (CLP); COP and PEN are also available. quote_volume_24h is in the quote currency; change is from Buda's 24h/7d price variation. Buda has no 24h high/low in its ticker.", "source": "Buda public API (buda.com/api/v2, live)", "service": "buda-api", "endpoints": { "GET /v1/book": "Live order-book depth — best bid/ask and spread (market=BTC-CLP, limit=20).", "GET /v1/meta": "This document.", "GET /v1/ticker": "Ticker for one market (market=BTC-CLP or base=BTC"e=CLP).", "GET /v1/markets": "Tradable pairs with base/quote (quote=CLP optional).", "GET /v1/tickers": "All markets for a quote ranked by 24h turnover (quote=CLP, limit=50)." }, "description": "Live spot market data from Buda.com, a leading Latin American crypto exchange (Chile, Colombia, Peru). The ticker endpoint returns a market's last price, best bid/ask, 24h and 7d change and base/quote volume; the tickers endpoint ranks every market for a quote currency (CLP, COP, PEN, or BTC/USDC/USDT) by 24h turnover; the markets endpoint lists tradable pairs with base/quote; the book endpoint returns live order-book depth. Live, no key, nothing stored. A distinct Latin-American venue for CLP/COP/PEN price discovery, separate from the USD/USDT-quoted exchange feeds.", "market_count": 26, "upstream_status": "ok" …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/buda-api OpenAPI spec: https://www.oanor.com/api/buda-api/openapi.json