Buda API
Buda API as documented publicly: 19 operations. Contract generated from the documentation by API Evangelist (2026-11-16); not the provider's own document.
Buda API as documented publicly: 19 operations. Contract generated from the documentation by API Evangelist (2026-11-16); not the provider's own document.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/buda:buda-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.1.0
info:
title: Buda API
version: '2026-11-16'
description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-16: 19 operation(s) read from 2 public documentation page(s) (each operation
names its page in x-source). This is not the provider''s published contract; Buda has published no machine-readable contract that the pipeline
could find. Engine: local.'
x-evidence-tiers:
code-example: 0
documentation: 19
pages-with-code: 0
pages-read: 2
x-generated-from: documentation
x-provenance: generated
x-authored-by: API Evangelist
x-generated: '2026-11-16'
x-generator: generate-contract-from-docs.py
x-engine: local
x-sources:
- https://api.buda.com
- https://api.buda.com/en
servers:
- url: https://www.buda.com/api/v2
paths:
/api/v2/orders:
delete:
operationId: delete_api_v2_orders
tags:
- Api
summary: Cancelar Todas Mis Órdenes
x-source: https://api.buda.com
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteApiV2OrdersResponse'
x-evidence:
kind: documentation
/api/v2/tickers:
get:
operationId: get_api_v2_tickers
tags:
- Api
summary: Todos los Tickers
x-source: https://api.buda.com
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/GetApiV2TickersResponse'
x-evidence:
kind: documentation
/balances:
get:
operationId: get_balances
tags:
- Balances
summary: Muestra los balances de tu cuenta, en cada moneda.
x-source: https://api.buda.com
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/GetBalancesResponse'
x-evidence:
kind: documentation
/contacts:
get:
operationId: get_contacts
tags:
- Contacts
summary: Obtener contactos
x-source: https://api.buda.com
parameters:
- name: kind
in: query
required: false
schema:
type: string
description: Filtra por tipo de contacto. Para remesas usar remittance.
- name: state
in: query
required: false
schema:
type: string
description: Filtra por estado (ver tabla Estados del contacto). Para remesas, usa verified.
- name: per
in: query
required: false
schema:
type: string
description: Cantidad de resultados por página.
- name: page
in: query
required: false
schema:
type: string
description: Número de página.
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/GetContactsResponse'
x-evidence:
kind: documentation
/currencies/{currency}/banks:
get:
operationId: get_currencies_currency_banks
tags:
- Currencies
summary: Obtener códigos de banco
x-source: https://api.buda.com
parameters:
- name: currency
in: path
required: true
schema:
type: string
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/GetCurrenciesCurrencyBanksResponse'
x-evidence:
kind: documentation
/lightning_network_invoices:
post:
operationId: post_lightning_network_invoices
tags:
- Lightning Network Invoices
summary: Crea un Invoice de Lightning Network ⚡️
x-source: https://api.buda.com
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PostLightningNetworkInvoicesRequest'
responses:
'201':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/PostLightningNetworkInvoicesResponse'
x-evidence:
kind: documentation
/markets:
get:
operationId: get_markets
tags:
- Markets
summary: 'Esta llamada entrega un objeto con el siguiente formato:'
x-source: https://api.buda.com
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/GetMarketsResponse'
x-evidence:
kind: documentation
/markets/BTC-CLP/trades:
get:
operationId: get_markets_BTC_CLP_trades
tags:
- Markets
summary: 'Esta llamada entrega un objeto con el siguiente formato:'
x-source: https://api.buda.com
parameters:
- name: timestamp
in: query
required: false
schema:
type: string
description: Unix timestamp en milisegundos del trade más reciente a solicitar.
- name: limit
in: query
required: false
schema:
type: string
description: 'Número de trades solicitados [default: 50, max: 100]'
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/GetMarketsBtcClpTradesResponse'
x-evidence:
kind: documentation
/me:
get:
operationId: get_me
tags:
- Me
summary: Muestra la información personal de tu cuenta.
x-source: https://api.buda.com
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/GetMeResponse'
x-evidence:
kind: documentation
/orders:
post:
operationId: post_orders
tags:
- Orders
summary: Crea y/o cancela órdenes por lotes
x-source: https://api.buda.com
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PostOrdersRequest'
responses:
'201':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/PostOrdersResponse'
x-evidence:
kind: documentation
put:
operationId: put_orders
tags:
- Orders
summary: Cancel Order
x-source: https://api.buda.com/en
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PutOrdersRequest'
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/PutOrdersResponse'
x-evidence:
kind: documentation
/orders/by-client-id:
get:
operationId: get_orders_by_client_id
tags:
- Orders
summary: Order Details by Client ID
x-source: https://api.buda.com/en
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/GetOrdersByClientIdResponse'
x-evidence:
kind: documentation
put:
operationId: put_orders_by_client_id
tags:
- Orders
summary: Cancel Order by Client ID
x-source: https://api.buda.com/en
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PutOrdersByClientIdRequest'
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/PutOrdersByClientIdResponse'
x-evidence:
kind: documentation
/remittance_recipients:
get:
operationId: get_remittance_recipients
tags:
- Remittance Recipients
summary: Obtener todos los destinatarios
x-source: https://api.buda.com
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/GetRemittanceRecipientsResponse'
x-evidence:
kind: documentation
/remittances:
get:
operationId: get_remittances
tags:
- Remittances
summary: Get Remittance
x-source: https://api.buda.com/en
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/GetRemittancesResponse'
x-evidence:
kind: documentation
/reserved_price_orders:
post:
operationId: post_reserved_price_orders
tags:
- Reserved Price Orders
summary: Nueva Orden de precio reservado
x-source: https://api.buda.com
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PostReservedPriceOrdersRequest'
responses:
'201':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/PostReservedPriceOrdersResponse'
x-evidence:
kind: documentation
put:
operationId: put_reserved_price_orders
tags:
- Reserved Price Orders
summary: Confirmar o cancelar Orden de precio reservado
x-source: https://api.buda.com
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PutReservedPriceOrdersRequest'
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/PutReservedPriceOrdersResponse'
x-evidence:
kind: documentation
/reserves/ln-btc/withdrawals:
post:
operationId: post_reserves_ln_btc_withdrawals
tags:
- Reserves
summary: Nuevo Retiro Lightning ⚡️
x-source: https://api.buda.com
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PostReservesLnBtcWithdrawalsRequest'
responses:
'201':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/PostReservesLnBtcWithdrawalsResponse'
x-evidence:
kind: documentation
/tickers:
get:
operationId: get_tickers
tags:
- Tickers
summary: 'Esta llamada entrega un objeto con el siguiente formato:'
x-source: https://api.buda.com
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/GetTickersResponse'
x-evidence:
kind: documentation
components:
schemas:
DeleteApiV2OrdersResponse:
type: object
properties:
message:
type: string
description: Resultado de la cancelación masiva.
GetApiV2TickersResponse:
type: object
properties:
tickers:
type: array
description: Lista de tickers de todos los mercados.
tickers[].market_id:
type: string
description: Identificador del mercado.
tickers[].last_price:
type: array
description: '[amount, currency] Precio de la última orden ejecutada.'
tickers[].price_variation_24h:
type: number
description: Variación del precio en las últimas 24h.
tickers[].price_variation_7d:
type: number
description: Variación del precio en los últimos 7 días.
GetBalancesResponse:
type: object
properties:
balances:
type: array
description: Lista de balances por moneda
id:
type: string
description: Identificador de la moneda
amount:
type: array
description: '[cantidad total, moneda]'
available_amount:
type: array
description: '[cantidad disponible, moneda]'
frozen_amount:
type: array
description: '[cantidad congelada, moneda]'
pending_withdraw_amount:
type: array
description: '[cantidad pendiente de retiro, moneda]'
GetContactsResponse:
type: object
properties:
contacts:
type: array
description: Lista de contactos.
contacts[].id:
type: string
description: ID del contacto (hashid).
contacts[].kind:
type: string
description: Tipo de contacto.
contacts[].state:
type: string
description: Estado del contacto.
contacts[].created_at:
type: string
description: Fecha de creación del contacto.
contacts[].details:
type: object
description: Datos del beneficiario.
meta:
type: object
description: Información de paginación.
GetCurrenciesCurrencyBanksResponse:
type: object
properties:
banks:
type: array
description: Lista de bancos disponibles para la moneda especificada.
banks[].currency:
type: string
description: Moneda del banco.
banks[].id:
type: number
description: ID único del banco.
banks[].name:
type: string
description: Nombre del banco.
banks[].code:
type: string
description: Código del banco.
PostLightningNetworkInvoicesRequest:
type: object
properties:
amount_satoshis:
type: string
description: Monto del invoice en satoshis.
currency:
type: string
description: Debe tener el valor BTC
memo:
type: string
description: La razón del invoice (una breve descripción)
expiry_seconds:
type: string
description: La cantidad de tiempo en segundos en la que el invoice expirará
required:
- amount_satoshis
- currency
PostLightningNetworkInvoicesResponse:
type: object
properties:
lightning_network_invoice.id:
type: integer
description: ID del invoice
lightning_network_invoice.currency:
type: string
description: La moneda del invoice
lightning_network_invoice.encoded_payment_request:
type: string
description: El invoice codificado
GetMarketsResponse:
type: object
properties:
markets:
type: array
description: Lista de mercados
id:
type: string
description: Identificador del mercado
name:
type: string
description: Nombre del mercado
base_currency:
type: string
description: Moneda de cambio
quote_currency:
type: string
description: Moneda de pago
minimum_order_amount:
type: array
description: '[cantidad, moneda]'
taker_fee:
type: string
description: Tarifa pagada por una orden taker
maker_fee:
type: string
description: Tarifa pagada por una orden maker
max_orders_per_minute:
type: integer
description: Rate Limit para trading que tiene este mercado
maker_discount_percentage:
type: string
description: Descuento Maker que tiene el mercado
taker_discount_percentage:
type: string
description: Descuento Taker que tiene el mercado
maker_discount_tiers:
type: object
description: Descuento Maker por tiers que tiene el mercado
taker_discount_tiers:
type: object
description: Descuento Taker por tiers que tiene el mercado
GetMarketsBtcClpTradesResponse:
type: object
properties:
trades:
type: object
description: Objeto contenedor de trades
timestamp:
type: string
description: Unix timestamp del trade más reciente incluido en la respuesta
last_timestamp:
type: string
description: Unix timestamp del trade más antiguo incluido en la respuesta
market_id:
type: string
description: Identificador del mercado consultado
entries:
type: array
description: '[timestamp, amount, price, direction]'
GetMeResponse:
type: object
properties:
user:
type: object
description: Objeto con datos del usuario
id:
type: string
description: Identificador de la cuenta
email:
type: string
description: Correo asociado a la cuenta
display_name:
type: string
description: Nombre completo asociado a la cuenta
monthly_transacted:
type: array
description: '[cantidad, moneda]'
pubsub_key:
type: string
description: Llave para autentificación con websockets
PostOrdersRequest:
type: object
properties:
mode:
type: string
description: Tipo de acción de la orden ( place / cancel )
type:
type: string
description: Dirección de la orden ( Bid / Ask )
price_type:
type: string
description: Tipo de orden ( limit / market )
limit:
type: string
description: Precio de la orden
amount:
type: string
description: Volumen de la orden
market_name:
type: string
description: 'La ID del mercado (Ej: btc-clp , eth-btc , etc)'
required:
- mode
- type
- price_type
- amount
- market_name
PostOrdersResponse:
type: object
properties:
success:
type: boolean
description: true cuando el lote de operaciones fue ejecutado con éxito
PutOrdersRequest:
type: object
properties:
state:
type: string
description: Must indicate "canceling"
required:
- state
PutOrdersResponse:
type: object
properties:
order:
type: object
description: Cancelled order details
id:
type: integer
description: Order ID
state:
type: string
description: Order state
amount:
type: array
description: Pending order volume
created_at:
type: string
description: Order creation timestamp
fee_currency:
type: string
description: Currency in which the fee is paid
client_id:
type: string
description: Order Client ID
limit:
type: array
description: Order price
market_id:
type: string
description: Market ID
original_amount:
type: array
description: Original order volume
paid_fee:
type: array
description: Fee paid by the order
price_type:
type: string
description: Order type (limit / market)
order_type:
type: string
description: Specific Order type (market / gtc / ioc / fok / post_only)
total_exchanged:
type: array
description: Total traded
traded_amount:
type: array
description: Volume transacted
type:
type: string
description: Order side (Bid / Ask)
GetOrdersByClientIdResponse:
type: object
properties:
order:
type: object
description: Order details
id:
type: integer
description: Order ID
client_id:
type: string
description: Order Client ID
state:
type: string
description: Order state
type:
type: string
description: Order side (Bid / Ask)
market_id:
type: string
description: Market ID
fee_currency:
type: string
description: Currency in which the fee is paid
price_type:
type: string
description: Order type (limit / market)
order_type:
type: string
description: Specific Order type (market / gtc / ioc / fok / post_only)
limit:
type: array
description: Order price
amount:
type: array
description: Pending order volume
original_amount:
type: array
description: Original order volume
traded_amount:
type: array
description: Volume transacted
total_exchanged:
type: array
description: Total traded
paid_fee:
type: array
description: Fee paid by the order
created_at:
type: string
description: Order creation timestamp
PutOrdersByClientIdRequest:
type: object
properties:
state:
type: string
description: Must indicate "canceling"
required:
- state
PutOrdersByClientIdResponse:
type: object
properties:
order:
type: object
description: Cancelled order details
id:
type: integer
description: Order ID
state:
type: string
description: Order state
amount:
type: array
description: Pending order volume
created_at:
type: string
description: Order creation timestamp
fee_currency:
type: string
description: Currency in which the fee is paid
client_id:
type: string
description: Order Client ID
limit:
type: array
description: Order price
market_id:
type: string
description: Market ID
original_amount:
type: array
description: Original order volume
paid_fee:
type: array
description: Fee paid by the order
price_type:
type: string
description: Order type (limit / market)
total_exchanged:
type: array
description: Total traded
traded_amount:
type: array
description: Volume transacted
type:
type: string
description: Order side (Bid / Ask)
GetRemittanceRecipientsResponse:
type: object
properties:
remittance_recipients:
type: array
description: Lista de destinatarios de remesas.
remittance_recipients[].id:
type: number
description: ID del destinatario.
remittance_recipients[].state:
type: string
description: Estado del destinatario.
remittance_recipients[].created_at:
type: string
description: Fecha de creación del destinatario.
remittance_recipients[].account_holder_name:
type: string
description: Nombre completo del titular de la cuenta.
remittance_recipients[].account_holder_type:
type: string
description: 'Tipo de titular: personal o business.'
remittance_recipients[].account_number:
type: string
description: Número de cuenta bancaria.
remittance_recipients[].inter_bank_number:
type: string
description: Número de cuenta interbancaria.
remittance_recipients[].document_number:
type: string
description: Número de documento de identidad del titular.
remittance_recipients[].bank_id:
type: number
description: ID del banco de destino.
GetRemittancesResponse:
type: object
properties:
id:
type: string
description: Remittance ID (hashid).
state:
type: string
description: Remittance state.
origin_currency:
type: string
description: Origin currency.
destination_currency:
type: string
description: Destination currency.
expires_at:
type: string
description: Quotation expiration date.
created_at:
type: string
description: Quotation creation date.
client_reference_id:
type: string
description: UUID that serves as a client reference to identify the remittance.
recipient:
type: object
description: Object containing the remittance recipient information.
origin_amount:
type: array
description: Origin amount.
destination_amount:
type: array
description: Amount that the recipient will receive.
payment_method:
type: string
description: Payment method used for delivering funds.
refunded:
type: boolean
description: Indicates whether the origin funds have been returned.
PostReservedPriceOrdersRequest:
type: object
properties:
market_name:
type: string
description: 'ID del mercado en minúsculas (ej: btc-clp )'
amount:
type: string
description: Monto a cotizar. Puede ser número o Money array ["1000000", "CLP"]
quotation_type:
type: string
description: 'Uno de: bid_given_size , bid_given_value , ask_given_size , ask_given_value'
payment_type:
type: string
description: 'Tipo de pago: immediate'
simulate:
type: string
description: Si true, calcula y devuelve la cotización sin persistir la orden (dry-run)
required:
- market_name
- amount
- quotation_type
- payment_type
PostReservedPriceOrdersResponse:
type: object
properties:
reserved_price_order.id:
type: integer
description: ID de la Orden de precio reservado
reserved_price_order.market_id:
type: string
description: 'Mercado en mayúsculas (ej: BTC-CLP )'
reserved_price_order.account_id:
type: integer
description: External ID de la cuenta
reserved_price_order.order_type:
type: string
description: 'Dirección: bid o ask'
reserved_price_order.quotation_type:
type: string
description: Tipo de cotización usado
reserved_price_order.payment_type:
type: string
description: Tipo de pago ( immediate )
reserved_price_order.state:
type: string
description: 'Estado (tras create: quoted )'
reserved_price_order.base_currency:
type: string
description: Moneda base del mercado
reserved_price_order.quote_currency:
type: string
description: Moneda quote del mercado
reserved_price_order.base_amount:
type: string
description: Monto en base
reserved_price_order.quote_amount:
type: string
description: Monto en quote
reserved_price_order.fee:
type: string
description: Fee (en quote si bid; en base si ask)
reserved_price_order.created_at:
type: string
description: Fecha de creación (ISO8601)
reserved_price_order.expires_on:
type: string
description: Hasta cuándo vale el precio reservado (ISO8601)
reserved_price_order.reserved_seconds:
type: number
description: Segundos restantes hasta expires_on al momento de serializar
PutReservedPriceOrdersRequest:
type: object
properties:
id:
type: string
description: ID de la Orden de precio reservado
state:
type: string
description: 'Nuevo estado: "commited" para confirmar o "rejected" para cancelar'
required:
- id
- state
PutReservedPriceOrdersResponse:
type: object
properties:
reserved_price_order:
type: object
description: Objeto actualizado de la orden reservada
PostReservesLnBtcWithdrawalsRequest:
type: object
properties:
amount:
type: string
description: Volumen del retiro (en BTCs)
withdrawal_data.payment_request:
type: string
description: Invoice del pago lightning
simulate:
type: string
description: Permite simular la solicitud de retiro
required:
- amount
- withdrawal_data.payment_request
PostReservesLnBtcWithdrawalsResponse:
type: object
properties:
withdrawal.id:
type: integer
description: ID del retiro
withdrawal.created_at:
type: string
description: Fecha de creación de la solicitud
withdrawal.amount:
type: string
description: Cantidad asociada al retiro
withdrawal.currency:
type: string
description: Moneda asociada al retiro
withdrawal.fee:
type: string
description: Tarifa asociada a la ejecución del retiro
withdrawal.state:
type: string
description: 'Estado de la solicitud (Ej: confirmed , rejected )'
withdrawal.withdrawal_data.type:
type: string
description: Siempre dirá lightning_network_withdrawal_data
withdrawal.withdrawal_data.payment_request:
type: string
description: Invoice usado para generar el retiro
withdrawal.withdrawal_data.payment_error:
type: string
description: Información con errores al realizar la transacción lightning, si hay
GetTickersResponse:
type: object
properties:
tickers:
type: array
description: Lista de tickers
market_id:
type: string
description: Identificador del mercado
last_price:
type: array
description: '[precio, moneda]'
price_variation_24h:
type: string
description: Variación del precio en 24h
price_variation_7d:
type: string
description: Variación del precio en 7d
tags:
- name: Api
- name: Balances
- name: Contacts
- name: Currencies
- name: Lightning Network Invoices
- name: Markets
- name: Me
- name: Orders
- name: Remittance Recipients
- name: Remittances
- name: Reserved Price Orders
- name: Reserves
- name: Tickers