Skip to main content

Welcome to KillB API

The KillB API is a REST API that enables cryptocurrency on-ramps and off-ramps across Latin America. Convert between fiat currencies (COP, MXN, USD) and cryptocurrencies (USDC, USDT) with ease.

Base URLs

https://teste-94u93qnn.uc.gateway.dev
Use for development and testing with fake money.

Authentication

All API requests require authentication:
Authorization: Bearer YOUR_ACCESS_TOKEN

Authentication Guide

Learn how to authenticate with the API

API Structure

The KillB API is organized into the following resources:
ResourceDescriptionBase Path
AuthLogin and token management/api/v2/auth
UsersUser management and KYC/api/v2/users
AccountsBank accounts and wallets/api/v2/accounts
RampsOn/off-ramp transactions/api/v2/ramps
QuotationsPrice quotes/api/v2/quotations
SavingsCustodial accounts/api/v2/savings
WebhooksEvent notifications/api/v2/webhooks
CustomersCustomer management/api/v2/customers
BanksBank information/api/v2/banks

Making Requests

Request Format

All requests use JSON:
curl --request POST \
  --url https://teste-94u93qnn.uc.gateway.dev/api/v2/users \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "PERSON",
    "data": { /* user data */ }
  }'

Response Format

Successful responses return JSON with relevant data:
{
  "id": "resource-id",
  "status": "ACTIVE",
  /* other fields */
}
Error responses include error details:
{
  "errorCode": "USER.0001",
  "message": ["User not found"],
  "statusCode": "404"
}

Pagination

List endpoints support pagination:
GET /api/v2/users?page=1&limit=10
Response:
{
  "users": [ /* array of users */ ],
  "totalPage": 5
}

Idempotency

Use externalId field for idempotent operations:
{
  "externalId": "your-unique-id",
  /* other fields */
}
This prevents duplicate resource creation on retries.

Testing

Use sandbox environment for testing:

API Explorer

Explore the complete API reference using the navigation on the left. Each endpoint includes:
  • Request/response schemas
  • Code examples
  • Parameter descriptions
  • Error responses

Need Help?