# Buda.com API
> Buda.com is a cryptocurrency exchange operating in Chile, Colombia and Peru. Its API has two core capabilities: programmatic crypto trading (place, manage and cancel orders on spot markets) and Cross Border Payments (international remittances between Latin American countries). It also exposes public market data and a Websockets API for real-time streams. All REST endpoints live under the base URL `https://www.buda.com/api/v2` and return JSON.
Key facts for agents:
- Base URL: `https://www.buda.com/api/v2`
- Markets are identified as `-` in lowercase, e.g. `btc-clp`, `eth-cop`
- Monetary amounts are returned as `[amount, currency]` pairs where the amount is a string to preserve precision, e.g. `["4.97241513", "BTC"]`
- Public endpoints require no authentication
- Private endpoints require an API key and an HMAC-SHA384 signature sent in the `X-SBTC-APIKEY`, `X-SBTC-NONCE` and `X-SBTC-SIGNATURE` headers (see Authentication below)
- Rate limits: 120 requests/minute per IP for anonymous calls, 375 requests/minute per API key for authenticated calls (~20 requests/second max); exceeding them returns HTTP `429`
- OAuth is also available for third-party apps; contact api.support@buda.com
- Websockets endpoint: `wss://realtime.buda.com/sub?channel=[channel]`
- Human docs: Spanish at https://api.buda.com/ and English at https://api.buda.com/en/
- The complete API reference as a single plain-text file: https://api.buda.com/llms-full.txt
## Trading
Typical flow: check the ticker or order book → optionally simulate the order → place it → poll its state until `traded`.
For reserved price orders: quote with `POST /reserved_price_orders` → confirm with `PUT /reserved_price_orders/` (`state: "commited"`) before `expires_on`. This is separate from order book limit/market orders.
- [Simulate Orders](https://api.buda.com/en/#rest-api-public-endpoints-simulate-orders): `POST /markets//quotations` — preview amounts and fees of an order without placing it (public, no auth needed)
- [New Order](https://api.buda.com/en/#rest-api-private-endpoints-new-order): `POST /markets//orders` — place limit, market or stop orders (`Bid` to buy, `Ask` to sell)
- [New Reserved Price Order](https://api.buda.com/en/#rest-api-private-endpoints-new-reserved-price-order): `POST /reserved_price_orders` — quote a reserved price for a limited time (`quoted`); use `simulate: true` for a dry-run
- [Reserved Price Order Details](https://api.buda.com/en/#rest-api-private-endpoints-reserved-price-order-details): `GET /reserved_price_orders/` — fetch a single reserved price order
- [My Reserved Price Orders](https://api.buda.com/en/#rest-api-private-endpoints-my-reserved-price-orders): `GET /reserved_price_orders` — list your reserved price orders (paginated)
- [Confirm or Cancel Reserved Price Order](https://api.buda.com/en/#rest-api-private-endpoints-confirm-or-cancel-reserved-price-order): `PUT /reserved_price_orders/` — confirm with `state: "commited"` or cancel with `rejected`
- [Batch Orders](https://api.buda.com/en/#rest-api-private-endpoints-batch-orders): `POST /orders` — place and cancel multiple orders in a single request
- [My Orders](https://api.buda.com/en/#rest-api-private-endpoints-my-orders): `GET /markets//orders` — list your orders in a market, filterable by state
- [Order state](https://api.buda.com/en/#rest-api-private-endpoints-order-state): lifecycle states of an order (pending, received, traded, canceling, canceled)
- [Order Details](https://api.buda.com/en/#rest-api-private-endpoints-order-details): `GET /orders/` — full details of a single order, including executed amounts
- [Cancel Order](https://api.buda.com/en/#rest-api-private-endpoints-cancel-order): `PUT /orders/` — cancel a pending order
- [Order Details by Client ID](https://api.buda.com/en/#rest-api-private-endpoints-order-details-by-client-id): `GET /orders/by-client-id/` — look up an order by your own identifier
- [Cancel Order by Client ID](https://api.buda.com/en/#rest-api-private-endpoints-cancel-order-by-client-id): `PUT /orders/by-client-id/` — cancel an order by your own identifier
- [Cancel All](https://api.buda.com/en/#rest-api-private-endpoints-cancel-all): `DELETE /orders` — cancel all open orders, optionally filtered by market
Trading endpoints have their own per-market rate limits depending on account tier (100–250 requests/minute), see [Rate Limits](https://api.buda.com/en/#rest-api-rate-limits).
## Cross Border Payments
International remittances between countries. Typical flow: quote the remittance (`POST /remittances`) → accept the quotation (`PUT /remittances/`) → track it until delivered. A contact is not required to quote — recipient data can be passed inline via `recipient_data`, or you can reference a previously created contact for reuse.
- [Introduction](https://api.buda.com/en/#cross-border-payments-introduction): product overview and remittance flow
- [Contacts](https://api.buda.com/en/#cross-border-payments-contacts): `GET /contacts`, `GET /contacts/`, `POST /contacts`, `DELETE /contacts/` — manage remittance recipients' contact data
- [Contact requirements](https://api.buda.com/en/#cross-border-payments-contacts-get-requirements-to-create-a-contact): `POST /contacts/requirements` — discover which fields are required per destination country/currency before creating a contact
- [Quote remittance](https://api.buda.com/en/#cross-border-payments-quote-remittance): `POST /remittances` — create a remittance quotation with amounts, exchange rate and recipient data; includes per-country `recipient_data` schemas (bank transfer, Yape/Plin, Pago Móvil) and `GET /currencies/{currency}/banks` for destination bank codes
- [Accept quotation](https://api.buda.com/en/#cross-border-payments-accept-quotation): `PUT /remittances/` — confirm a quoted remittance for execution
- [Get Remittance](https://api.buda.com/en/#cross-border-payments-get-remittance): `GET /remittances/` — status and details of a remittance
- [My remittances](https://api.buda.com/en/#cross-border-payments-my-remittances): `GET /remittances` — list your remittances
- [Remittance recipients](https://api.buda.com/en/#cross-border-payments-remittance-recipients): `GET /remittance_recipients`, `GET /remittance_recipients/` — recipients saved from past remittances
- [Errors](https://api.buda.com/en/#cross-border-payments-errors): CBP-specific error codes
## Market data (public, no auth)
- [Markets](https://api.buda.com/en/#rest-api-public-endpoints-markets): `GET /markets`, `GET /markets/` — list available markets and their details
- [Ticker](https://api.buda.com/en/#rest-api-public-endpoints-ticker): `GET /markets//ticker` — current price, bid/ask and 24h stats
- [All Tickers](https://api.buda.com/en/#rest-api-public-endpoints-all-tickers): `GET /tickers` — tickers for every market in one call
- [Order Book](https://api.buda.com/en/#rest-api-public-endpoints-order-book): `GET /markets//order_book` — current bids and asks
- [Trade History](https://api.buda.com/en/#rest-api-public-endpoints-trade-history): `GET /markets//trades` — most recent public trades
- [Transacted Volume](https://api.buda.com/en/#rest-api-public-endpoints-transacted-volume): `GET /markets//volume` — traded volume for a market
- [Deposit/Withdrawal Fees](https://api.buda.com/en/#rest-api-public-endpoints-deposit-withdrawal-fees): `GET /currencies//fees/` — current deposit and withdrawal fees
## Account & funding (private)
- [Authentication](https://api.buda.com/en/#rest-api-private-endpoints-authentication): how to sign requests with your API key (HMAC-SHA384 over method, path, base64 body and nonce)
- [Pagination](https://api.buda.com/en/#rest-api-private-endpoints-pagination): `page` / `per` query params and pagination metadata
- [Account Information](https://api.buda.com/en/#rest-api-private-endpoints-account-information): `GET /me` — account details of the authenticated user
- [Balances](https://api.buda.com/en/#rest-api-private-endpoints-balances): `GET /balances`, `GET /balances/` — wallet balances (available, frozen, pending)
- [Deposit/Withdrawal History](https://api.buda.com/en/#rest-api-private-endpoints-deposit-withdrawal-history): `GET /currencies//deposits`, `GET /currencies//withdrawals` — past deposits and withdrawals
- [New Fiat Deposit](https://api.buda.com/en/#rest-api-private-endpoints-new-fiat-deposit): `POST /currencies//deposits` — register a fiat deposit
- [New Fiat Withdrawal](https://api.buda.com/en/#rest-api-private-endpoints-new-fiat-withdrawl): `POST /currencies//withdrawals` — withdraw fiat to a bank account
- [New Crypto Deposit](https://api.buda.com/en/#rest-api-private-endpoints-new-crypto-deposit): `POST /currencies//receive_addresses`, `GET /currencies//receive_addresses/` — create and fetch crypto deposit addresses
- [New Crypto Withdrawal](https://api.buda.com/en/#rest-api-private-endpoints-new-crypto-withdrawal): `POST /currencies//withdrawals` — send crypto to an external address
- [New Lightning Withdrawal](https://api.buda.com/en/#rest-api-private-endpoints-new-lightning-withdrawal): `POST /reserves/ln-btc/withdrawals` — pay a Lightning Network invoice
- [New Lightning Deposit](https://api.buda.com/en/#rest-api-private-endpoints-new-lightning-deposit): `POST /lightning_network_invoices` — generate a Lightning invoice to receive BTC
- [Rate Limits](https://api.buda.com/en/#rest-api-rate-limits): request limits for general and trading calls
- [Errors](https://api.buda.com/en/#rest-api-errors): error response format and common error codes
## Websockets API
- [Introduction](https://api.buda.com/en/#websockets-api-introduction): connect to `wss://realtime.buda.com/sub?channel=[channel]`; multiple channels can be combined with commas
- [Order Book channel](https://api.buda.com/en/#websockets-api-public-channels-order-book): real-time order book updates per market
- [Public Trades channel](https://api.buda.com/en/#websockets-api-public-channels-public-trades): real-time public trade executions
- [Balances channel](https://api.buda.com/en/#websockets-api-private-channels-balances): real-time balance updates for your account (requires pubsub key)
- [My Orders channel](https://api.buda.com/en/#websockets-api-private-channels-my-orders): real-time updates on your own orders
- [Confirmed Deposits channel](https://api.buda.com/en/#websockets-api-private-channels-confirmed-deposits): notifications when your deposits are confirmed
## Optional
- [OAuth](https://api.buda.com/en/#oauth): authorize third-party applications without sharing credentials
- [Spanish documentation](https://api.buda.com/): same reference in Spanish
- [Changelog](https://api.buda.com/en/#changelog): API changes over time
- [Manage API Keys](https://www.buda.com/manejar_api_keys): create and manage API keys (requires a Buda.com account)