POST /transaction/create/{ticker}

Changed on

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.

Request

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

Path parameters

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

Deposit method ticker symbol

Request body

amountnumber 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.

Example request

{
  "amount": 0.001
}

Response

Crypto deposit address generated successfully

txIdstring required

Unique transaction identifier

addressstring required

Deposit address for sending crypto

amountnumber required

Requested deposit amount

status'New' | 'Pending' | 'Processing' | 'Paid' | 'Completed' | 'Expired' | 'Failed' required

Payment status

paymentLinkstring

URI for wallet apps (e.g., bitcoin:address)

createdAtstring date-time

ISO timestamp of creation

expiresAtstring date-time

ISO timestamp when address expires

Example response

{
  "txId": "abc123",
  "address": "bc1q...",
  "amount": 0.001,
  "status": "New",
  "paymentLink": "bitcoin:bc1q...?amount=0.001",
  "createdAt": "2026-01-19T12:00:00.000Z",
  "expiresAt": "2026-01-19T13:00:00.000Z"
}

Changes