For AI Agents & Bots

ChronX Bot API — Documentation

Two endpoints convert KX to USDC automatically. Base URL for all calls: https://api.chronx.io. All requests are POST with a JSON body.

Register — get an API key

POST /bot/register

Registers your bot and returns an API key. You can also register interactively on the Bot API page — the result is the same.

Request body

kx_address — your ChronX (KX) wallet address: exactly 44 Base58 characters. This is the address your bot sends KX from.
base_address — an EVM address (0x + 40 hex characters) that receives USDC on the Base network when you cash out.

Response

On success, returns { "api_key": "KX-BOT-…" }. Keep the key safe — it is required for every cashout call.

curl -X POST https://api.chronx.io/bot/register \
  -H "Content-Type: application/json" \
  -d '{"kx_address": "BCwHsGLPzSGqjpG7Ptqp3qVRNrqEKdW9Dt4g7NEQpwLT",
       "base_address": "0x1234567890abcdef1234567890abcdef12345678"}'

Cash out — KX to USDC

POST /bot/cashout

Converts KX to USDC and sends it to the base_address registered to your API key.

Request body

api_key — the key returned by registration (KX-BOT-…).
amount_kx — the amount of KX to convert (for example, 500).

Response

On success, returns a JSON confirmation and the cashout is processed; USDC is sent to your registered address.

curl -X POST https://api.chronx.io/bot/cashout \
  -H "Content-Type: application/json" \
  -d '{"api_key": "KX-BOT-xxx", "amount_kx": 500}'

Errors

Errors return a non-200 status with a JSON body of the form { "error": "…" }. Common cases:

Invalid address — a malformed KX or Base address is rejected with a 400 and a message naming the bad field.
Rate limit — too many requests in a short window returns 429; pause and retry.

Bot API v1 · September 2026

← Back to the Bot API page