Crypto Deposits

Generate cryptocurrency deposit addresses programmatically

Overview

The crypto deposits feature enables users to programmatically generate deposit addresses for multiple cryptocurrencies. Accounts are automatically credited when payments confirm on the blockchain.

Supported Cryptocurrencies

Ticker	Name	Min USD	Max USD
BTC	Bitcoin	$1.00	$2,000
BTC-LN	Bitcoin Lightning	$0.10	$2,000
LTC	Litecoin	$1.00	$2,000
LTC-MWEB	Litecoin MWEB	$1.00	$2,000
XMR	Monero	$1.00	$2,000
DOGE	Dogecoin	$1.00	$2,000
DASH	Dash	$1.00	$2,000
ZEC	Zcash	$0.10	$500
BCH	Bitcoin Cash	$1.00	$2,000
BAN	Banano	$1.00	$2,000
KAS	Kaspa	$1.00	$500
TON	Toncoin	$1.00	$500
NEAR	NEAR Protocol	$1.00	$500
EGLD	MultiversX	$0.20	$100
ZANO	Zano	$1.00	$2,000
FUSD	Fantom USD	$1.00	$2,000

Authentication

All endpoints require API key authentication using one of these methods:

# Method 1: Authorization header
curl -H "Authorization: Bearer YOUR_API_KEY"

# Method 2: x-api-key header  
curl -H "x-api-key: YOUR_API_KEY"

Create Crypto Deposit

Generate a deposit address for cryptocurrency deposits

ticker · string · required

Cryptocurrency ticker symbol. Supported values: btc, btc-ln, ltc, ltc-mweb, xmr, doge, dash, zec, bch, ban, kas, ton, near, egld, zano, fusd

amount · number · required

Amount of cryptocurrency to deposit. Must be between minimum and maximum limits.

cURL

curl -X POST https://nano-gpt.com/api/transaction/create/btc \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 0.001}'

Success 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"
}

Response Fields

txId · string

Unique transaction identifier for tracking

address · string

Deposit address for sending crypto

amount · number

Requested deposit amount

status · string

Payment status: New, Pending, Processing, or Completed

paymentLink · string

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

createdAt · string

ISO timestamp of creation

expiresAt · string

ISO timestamp when address expires

Check Payment Limits

Get minimum and maximum deposit amounts for a cryptocurrency

ticker · string · required

Cryptocurrency ticker symbol

cURL

curl https://nano-gpt.com/api/transaction/limits/kas \
  -H "Authorization: Bearer YOUR_API_KEY"

Limits Response

{
  "minimum": 10.5,
  "maximum": 5250,
  "fiatEquivalentMinimum": 1,
  "fiatEquivalentMaximum": 500,
  "timestamp": 1705669200
}

Error Handling

HTTP Status Codes

Code	Description
200	Success
400	Invalid amount, unsupported ticker, or below/above limits
401	Authentication failure
429	Rate limited
500	Provider unavailable or internal error

Common Error Messages

Amount Validation Errors

• "No amount specified" - Missing amount in request body
• "Invalid amount. Must be a positive number." - Amount validation failed
• "Minimum amount is X" - Below minimum threshold
• "Maximum amount is X" - Above maximum threshold

Provider Errors

• "Unsupported ticker" - Ticker not supported
• "This payment method is currently not available" - Provider temporarily unavailable

Rate Limits

• 10 requests per 10 minutes per IP address or API key
• Rate limit applies to all deposit creation endpoints

Payment Flow

1. Create Invoice

   Call /api/transaction/create/{ticker} with desired amount

2. Get Address

   Extract address from response

3. Send Payment

   User sends crypto to the provided address

4. Auto-Credit

   Account balance automatically updated when payment confirms