Wallet REST API

Lee y gestiona tus datos financieros

Lee y gestiona tus datos de Wallet — transacciones, cuentas, presupuestos y más — desde Excel, Power BI, scripts y herramientas de automatización mediante una API REST segura.

Referencia completa de la APIOpenAPI spec
Wallet REST API
GET
https://rest.budgetbakers.com/wallet
/v1/api/records?limit=30
Response:
{
"records": [
{
"id": "3643bf2e-…",
"counterParty": "Billa",
"amount": { "value": -612, "currencyCode": "CZK" },
"recordDate": "2026-06-09T11:09:00Z",
"category": { "name": "Groceries", … },
"recordType": "expense",
"paymentType": "debit_card"
}, …
]
}

Primeros pasos

1

Obtén Wallet Premium

La REST API está disponible para suscriptores de Wallet Premium. Actualiza tu cuenta para desbloquear el acceso a la API.

2

Genera tu token API

Ve a Ajustes en la aplicación web de Wallet y genera tu token de API personal. Guárdalo en un lugar seguro: da acceso a tus datos.

3

Haz tu primera solicitud

Usa la URL base y tu token para empezar a consultar tus datos financieros; pruébalo en vivo en el explorador interactivo de la API.

Datos disponibles

Acceso de lectura completo a todo — y creación, actualización y borrado donde importa.

Datos financieros principales

GETPOSTPATCH/v1/api/records

Records

Transacciones con filtros avanzados — crea hasta 20 y actualiza hasta 10 por petición

GETPOSTPATCH/v1/api/accounts

Accounts

Cuentas bancarias, tarjetas y efectivo — listar, crear nuevas, renombrar y actualizar

GETPOSTPATCH/v1/api/categories

Categories

El árbol de categorías — añade subcategorías propias y renombra las tuyas

Planificación y organización

GETPOSTPATCH/v1/api/budgets

Budgets

Definiciones y seguimiento de presupuestos — créalos y ajústalos

GET/v1/api/goals

Goals

Metas de ahorro y su progreso

GET/v1/api/standing-orders

Standing Orders

Pagos recurrentes — /items lista las ocurrencias generadas

GETPOSTPATCH/v1/api/labels

Labels

Etiquetas de transacciones — listar, crear, renombrar y recolorear

GET/v1/api/record-rules

Record Rules

Reglas de categorización automática

Mantenimiento y monitorización

GET/v1/api/{type}/references

Entity References

Búsqueda por lotes de entidades relacionadas — una comprobación segura antes de borrar

DELETE/v1/api/{type}

Delete Entities

Borra hasta 10 registros, presupuestos, cuentas, etiquetas y más por petición

GET/v1/api/api-usage/stats

API Usage Stats

Supervisa tu uso de la API y la cuota restante

Conceptos clave

Paginación

Controla los conjuntos de resultados con parámetros limit y offset.

  • limit — hasta 200 resultados por petición (30 por defecto)
  • offset — omite N resultados
  • nextOffset — se devuelve cuando hay más resultados

Filtrado

Usa prefijos tipados para filtrar datos con precisión.

  • eq., contains., contains-i. — filtros de texto
  • gt., gte., lt., lte. — comparaciones de rango
  • Repite un filtro (hasta 2×) para rangos AND

Límites y cabeceras

Limitación token-bucket que permite ráfagas cortas, con cabeceras HTTP claras.

  • 300 peticiones por hora por cliente
  • X-RateLimit-Limit, X-RateLimit-Remaining
  • 429 + Retry-After al superar el límite

Escrituras por lotes

Escribe en lotes pequeños y predecibles: los elementos se procesan de forma independiente.

  • POST /records — hasta 20 elementos
  • PATCH — hasta 10 elementos
  • DELETE — hasta 10 IDs

Conviene saber

Conversión de divisas

La API REST utiliza automáticamente tipos de cambio históricos para operaciones entre divisas. La conversión sigue un enfoque de mejor esfuerzo: los tipos provienen de datos públicos de mercado y pueden diferir ligeramente de los de bancos o casas de cambio.

Totales y ordenación

withTotal=true devuelve el total de coincidencias junto a la página; sortBy ordena por cualquier campo compatible (+ ascendente, - descendente).

Estado de sincronización

Tu primer token de API inicia una sincronización inicial (las peticiones devuelven 409 hasta que termina). Después, las cabeceras X-Last-Data-Change-At y X-Sync-In-Progress indican la frescura de los datos.

Éxito parcial (HTTP 207)

Los elementos del lote se procesan de forma independiente: los resultados mixtos devuelven un resumen por elemento. Añade validation=strict para fallar rápido en su lugar.

Ejemplos de integración

curl

La forma más sencilla de probar la API desde tu terminal.

curl -X GET "https://rest.budgetbakers.com/wallet/v1/api/records?limit=30" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

Excel con Power Query

Importa transacciones directamente a Excel para análisis y reportes personalizados.

  1. 1.Abre Excel → Datos → Obtener datos → Desde la web
  2. 2.Ingresa: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Agrega la cabecera Authorization con tu Bearer token
  4. 4.Transforma y carga los datos en tu hoja de cálculo

Power BI Dashboard

Crea dashboards financieros en tiempo real con actualización automática de datos.

  1. 1.Usa el conector Web en Power BI Desktop
  2. 2.URL: https://rest.budgetbakers.com/wallet/v1/api/records
  3. 3.Configura la autenticación con Bearer token
  4. 4.Configura la actualización programada y crea visualizaciones

Análisis con Python

Analiza tus datos financieros programáticamente con Python.

import requests

headers = {'Authorization': 'Bearer YOUR_TOKEN'}
params = {
    'recordDate': 'gte.2025-01-01',
    'limit': 100
}

response = requests.get(
    'https://rest.budgetbakers.com/wallet/v1/api/records',
    headers=headers,
    params=params
)

data = response.json()
for rec in data['records']:
    amount = rec['amount']
    print(f"{rec['recordDate'][:10]} {rec['counterParty']}: "
          f"{amount['value']} {amount['currencyCode']}")

¿Listo para empezar?

Explora la referencia completa de la API con documentación interactiva, ejemplos de solicitudes y esquemas de respuesta.

Explorador interactivo de APIProbar integración MCP