Create Deposit Address

Generate a unique deposit address for a customer payment.

POST /v1/{chain}/{token}/create

Path Parameters

Parameter	Type	Description
`chain`	string	Blockchain network: `tron` or `bsc`
`token`	string	Token type: `usdt` or `usdc`

Request Body

Parameter	Type	Required	Description
`callback_url`	string	No	URL to receive webhook notifications
`expected_amount`	number	No	Expected payment amount (informational)
`metadata`	object	No	Custom metadata to attach to this address
`expires_in`	number	No	Address expiration in seconds

Example Request

curl -X POST "https://api.eqgate.com/v1/tron/usdt/create" \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_url": "https://your-site.com/webhook",
    "expected_amount": 100,
    "metadata": {
      "order_id": "ORD-12345",
      "customer_id": "CUST-789"
    },
    "expires_in": 3600
  }'

Response

{
  "status": "success",
  "address_in": "TXabc123def456ghi789jkl012mno345pqr678",
  "address_out": "TYdef456ghi789jkl012mno345pqr678stu901",
  "chain": "TRON",
  "token": "USDT",
  "callback_url": "https://your-site.com/webhook",
  "fee_percent": 0.5,
  "min_fee": 1,
  "expected_amount": 100,
  "expires_at": "2024-01-15T12:00:00.000Z",
  "created_at": "2024-01-15T11:00:00.000Z"
}

Response Fields

Field	Type	Description
`status`	string	Always `success`
`address_in`	string	Deposit address to show to customer
`address_out`	string	Your wallet where funds will be forwarded
`chain`	string	Blockchain network (uppercase)
`token`	string	Token type (uppercase)
`fee_percent`	number	Fee percentage (e.g., 0.5 = 0.5%)
`min_fee`	number	Minimum fee in USD

Code Examples

JavaScript

const response = await fetch('https://api.eqgate.com/v1/tron/usdt/create', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.EQGATE_API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    callback_url: 'https://your-site.com/webhook',
    expected_amount: 100,
    metadata: { order_id: 'ORD-12345' },
  }),
});
 
const data = await response.json();
console.log('Deposit address:', data.address_in);

Python

import requests
 
response = requests.post(
    'https://api.eqgate.com/v1/tron/usdt/create',
    headers={'X-API-Key': 'your_api_key'},
    json={
        'callback_url': 'https://your-site.com/webhook',
        'expected_amount': 100,
        'metadata': {'order_id': 'ORD-12345'}
    }
)
 
data = response.json()
print(f"Deposit address: {data['address_in']}")

Create Deposit Address

On this page