---
title: "POST /transaction/create/{ticker}"
method: POST
path: "/transaction/create/{ticker}"
---

# POST /transaction/create/{ticker}

`POST /transaction/create/{ticker}`

## Request

- Base URL: `https://api.nano-gpt.com/api`
- URL: `https://api.nano-gpt.com/api/transaction/create/{ticker}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Create a deposit payment intent for the specified ticker. Depending on the ticker, the response may include a pay-in address and/or a payment link. When payment confirms, the user's account balance is automatically credited.

## Path parameters

- `ticker` 'btc' | 'btc-ln' | 'ltc' | 'ltc-mweb' | 'xmr' | 'doge' | 'dash' | 'zec' | 'bch' | 'ban' | 'kas' | 'ton' | 'near' | 'egld' | 'vvv' | 'zano' | 'fusd', required

## Request body

- CryptoDepositRequest
  - `amount` number, required: Amount to deposit. Interpretation depends on ticker/provider (for example, crypto units for invoice-based deposits, or a USD/USDC amount for checkout-style deposits). Must be within the limits for the ticker.

## Response `200`

Crypto deposit address generated successfully

- CryptoDepositResponse
  - `txId` string, required: Unique transaction identifier
  - `address` string, required: Deposit address for sending crypto
  - `amount` number, required: Requested deposit amount
  - `status` 'New' | 'Pending' | 'Processing' | 'Paid' | 'Completed' | 'Expired' | 'Failed', required: Payment status
  - `paymentLink` string: URI for wallet apps (e.g., bitcoin:address)
  - `createdAt` string, date-time: ISO timestamp of creation
  - `expiresAt` string, date-time: ISO timestamp when address expires

## Other responses

- `400`: Bad Request - Invalid amount or unsupported ticker
- `401`: Unauthorized - Invalid or missing API key
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Server Error - Payment provider unavailable

## Changes

- **2026-11-03** `cc8b07d75689`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nano-gpt/apis/nanogpt-api/changes/transaction/create/:ticker/post.md)

---

[API](https://skmtc.dev/nano-gpt/apis/nanogpt-api.md) - [All operations](https://skmtc.dev/nano-gpt/apis/nanogpt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nano-gpt/apis/nanogpt-api/revisions/cc8b07d75689?raw)