API para operadores
Mantenga sus fichas exactas desde su propio sistema: estado, comisiones en vivo, horarios y cajeros nuevos.
Autenticación
Cree una clave en su panel y envíela como Authorization: Bearer km_live_…. Las claves de prueba (km_test_…) validan todo sin escribir nada.
Lo esencial
- Use nuestro id o su propio externalId en las URL.
- Un latido cada hora mantiene la ficha “Confirmado hace minutos”. Sin latidos por 30 días, la ficha aparece Sin confirmar.
- Las comisiones son totales (cargo más margen) como porcentaje del efectivo.
- Los cambios de dirección se revisan antes de publicarse.
- Límite: 600 solicitudes por minuto por clave (2,000 para latidos).
Latido: el cajero funciona, con comisiones en vivo
curl -X POST https://bitcoinscouts.com/api/v1/machines/YOUR-ID/heartbeat \
-H "Authorization: Bearer km_live_…" \
-H "Content-Type: application/json" \
-d '{"buyFeePct": 14.5, "sellFeePct": 7}'Marcar un cajero cerrado temporalmente
curl -X PATCH https://bitcoinscouts.com/api/v1/machines/YOUR-ID \
-H "Authorization: Bearer km_live_…" \
-H "Content-Type: application/json" \
-d '{"status": "closed", "reopensOn": "2026-11-02"}'Crear o actualizar muchos cajeros
curl -X POST https://bitcoinscouts.com/api/v1/machines/bulk \
-H "Authorization: Bearer km_live_…" \
-H "Content-Type: application/json" \
-d '{"machines": [{"externalId": "BT400123", "name": "Newark Ave Corner Market",
"street": "212 Newark Ave", "city": "Jersey City", "state": "NJ",
"buy": true, "sell": true, "coins": ["BTC","LTC"], "buyFeePct": 15}]}'Listar sus cajeros
curl https://bitcoinscouts.com/api/v1/machines?limit=100 -H "Authorization: Bearer km_live_…"