# 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)