---
title: "Create a recharge order."
method: POST
path: "/billing/recharge"
---

# Create a recharge order.

`POST /billing/recharge`

## Request

- Base URL: `https://api.nexalayer.net/v1`
- URL: `https://api.nexalayer.net/v1/billing/recharge`
- Auth: API key in header `X-API-Key`

## Headers

- `Idempotency-Key` string

## Request body

- union
  - object
    - `amount` number, required
    - `amount_usd` number
    - `currency` 'USDT'
  - object
    - `amount` number
    - `amount_usd` number, required
    - `currency` 'USDT'

## Response `201`

Recharge order created.

- RechargeResponse
  - `success` boolean
  - `data` object
    - `order_id` string
    - `amount_usd` number
    - `amount_usdt` number
    - `amount_cny` number
    - `exchange_rate` number
    - `network` string
    - `wallet_address` string
    - `wallet_explorer_url` string, uri
    - `status` string

## Other responses

- `409`: HTTP 409. PRICE_MISMATCH means the price changed since it was read; no order was placed, so re-read prices and retry. Also used for PRODUCT_OUT_OF_STOCK and IDEMPOTENCY_CONFLICT. See https://docs.nexalayer.net/en/errors.
- `429`: Request or trial limit exceeded.

---

[API](https://skmtc.dev/nexalayer/apis/nexalayer-agent-api.md) · [All operations](https://skmtc.dev/nexalayer/apis/nexalayer-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nexalayer/apis/nexalayer-agent-api/revisions/126d0d474804?raw)