◈ SYSTEM ONLINE ◈

CRYPTO WALLET API

MULTI-BLOCKCHAIN PAYMENT INFRASTRUCTURE // 14 NETWORKS

TRON  ·  BSC  ·  ETH  ·  TON  ·  SOL  ·  POLYGON  ·  ARB  ·  +7 MORE
⬡ Access Terminal

Придумайте секретный код — это ваш постоянный ключ доступа к API.
Минимум 20 символов. Запомните его — он заменяет пароль.

▸ Только вы знаете этот код. Если забудете — восстановить нельзя.
JWT TOKEN
◎ Как это работает
Шаг 1 — Регистрация
Введите секретный код → получаете JWT-токен. Тот же код = тот же аккаунт.
Шаг 2 — Аутентификация
Добавляйте токен в каждый запрос: Authorization: Bearer <token>
Шаг 3 — Работа
Создавайте кошельки, переводите криптовалюту, проверяйте балансы через REST API.
Base URL
—
Поддерживаемые сети
1 TRON TRX
2 BSC BNB
3 TON GRAM
4 ETH ETH
5 POLYGON MATIC
6 ARBITRUM ARB
7 SOLANA SOL
8 AVALANCHE AVAX
9 POLKADOT DOT
10 TEZOS XTZ
11 XRP XRP
12 DOGECOIN DOGE
13 CARDANO ADA
14 MONERO XMR
◈   API Documentation
Все эндпоинты кроме /api/register требуют заголовок:
Authorization: Bearer <your_jwt_token>
POST /api/register  или  /api/login Регистрация / Вход ▼
Запрос
{ "unique_hash": "your_secret_code_min_20_chars" }
Параметры
ПараметрТипОбязателенОписание
unique_hashstringДаСекретный код (мин. 20 символов). Одинаковый код = один аккаунт
Ответ 200
{ "success": true, "message": "User registered successfully", "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..." }
POST /api/wallets Список кошельков ▼
Запрос (опционально)
{ "node": "TRON", "mode": "standard" }
Параметры
ПараметрТипОбязателенОписание
nodestringНетФильтр по сети (TRON, BSC, ETH…)
modestringНет"standard" (по умолч.) или "gasfree"
Ответ 200
{ "success": true, "wallets": [ { "id": 1, "address": "TXyz123...", "node_id": 1, "network": "TRON", "mode": "standard" } ] }
POST /api/wallet/create Создать кошелёк ▼
Запрос (стандартный)
{ "node": "TRON" }
Запрос (GasFree — только TRON)
{ "node": "TRON", "mode": "gasfree" }
Параметры
ПараметрТипОбязателенОписание
nodestringДаСеть: TRON, BSC, ETH, TON, SOLANA…
modestringНет"standard" (по умолч.) или "gasfree" (только TRON)
Ответ 200
{ "address": "TXyz123abc...", "private_key": "abc123...", "node_id": 1, "created_at": "2025-02-19 12:00:00" }
POST /api/wallet/transfer Перевод средств ▼
Запрос (стандартный)
{ "node": "TRON", "address_from": "TXyz123...", "address_to": "TAbc456...", "amount": 10.5, "symbol": "TRX" }
Запрос (GasFree USDT)
{ "node": "TRON", "mode": "gasfree", "address_from": "TXyz123...", "address_to": "TAbc456...", "amount": 50, "symbol": "USDT" }
Параметры
ПараметрТипОбязателенОписание
nodestringДаСеть
address_fromstringДаАдрес отправителя
address_tostringДаАдрес получателя
amountfloatДаСумма (> 0)
symbolstringДаСимвол токена. GasFree — только USDT
modestringНет"standard" или "gasfree"
Ответ — стандартный
{ "success": true, "data": { "txid": "abc123def456...", "commission": 13.5 } }
Ответ — GasFree
{ "success": true, "data": { "traceId": "unique-trace-id-123", "mode": "gasfree", "fee": 10.0, "fee_token": "USDT" } }
POST /api/wallet/balance Баланс кошелька ▼
Запрос
{ "node": "TRON", "address": "TXyz123..." }
Ответ 200
{ "success": true, "network": "TRON", "address": "TXyz123...", "balances": [ { "symbol": "TRX", "balance": "100.5", "is_native": true }, { "symbol": "USDT", "balance": "250.0", "is_native": false, "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" } ] }
POST /api/wallet/gasfree/status Статус GasFree перевода ▼
Запрос
{ "trace_id": "unique-trace-id-123" }
Ответ 200
{ "success": true, "data": { "traceId": "...", "status": "SUCCESS", "txHash": "abc123..." } }
POST /api/wallet/gasfree/fees Комиссии GasFree ▼
Ответ 200
{ "success": true, "data": { "transfer_fee": 10.0, "activation_fee": 10.0, "fee_token": "USDT" } }
IDСетьНативная монетаТокены
1TRON GasFreeTRXUSDT (TRC20), USDC, ETH (TRC20)
2BSCBNBBSC-USD (BEP20)
3TONGRAMUSDT (Jetton)
4ETHETHUSDT, USDC (ERC20)
5POLYGONMATICUSDT, USDC, DAI
6ARBITRUMARBUSDT, USDC
7SOLANASOLSOL (SPL)
8AVALANCHEAVAXAVAX
9POLKADOTDOTDOT
10TEZOSXTZXTZ
11XRPXRPXRP
12DOGECOINDOGEDOGE
13CARDANOADAADA
14MONEROXMRXMR
Форматы адресов
СетьФорматПример
TRONT... (Base58)TJCnKsPa7y5okkXvQAidZBzqx3QyQ6sxMW
BSC / ETH / Polygon / Arbitrum / Avalanche0x... (Hex)0x742d35Cc6634C0532925a3b844Bc454...
TONEQ... / UQ... (Base64)EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W6...
SolanaBase587EYnhQoR9YM3N7UoaKRoA44Uy8JeaZV3q...
Polkadot1... (SS58)1FRMM8PEiWXYax7rpS6X4XZX1aAAxSWx1...
Tezostz1... (Base58Check)tz1VSUr8wwNhLAzempoch5d6hLRiTh8Cjcjb
XRPr... (Base58)rN7n3473SaZBCG4dFL83w7a1RXtXtbk2D9
DogecoinD... (Base58Check)D7DA74qzZUyh9cctCxWovPTEovUSjGzL2S
Cardanoaddr1... (Bech32)addr1qxck...xyz
Monero4... / 8... (Monero Base58)49qD5hvrDyzMrdPGwLRKNf2RhGsZKeLeueV...
GasFree — специальный режим для кошельков TRON. Позволяет переводить USDT без наличия TRX на балансе. Комиссия вычитается автоматически из суммы в USDT.
Только TRON
GasFree работает исключительно в сети TRON
Только USDT
Переводить можно только USDT. TRX, USDC и другие токены — не поддерживаются
traceId вместо txid
GasFree переводы возвращают traceId. Используйте /api/wallet/gasfree/status для отслеживания
Плата за активацию
Первый перевод с нового GasFree кошелька включает плату за активацию (в USDT)
Полный сценарий использования
// 1. Создать GasFree кошелёк POST /api/wallet/create { "node": "TRON", "mode": "gasfree" } // 2. Пополнить USDT на gasfree_address из ответа // 3. Перевести USDT (без TRX) POST /api/wallet/transfer { "node": "TRON", "mode": "gasfree", "address_from": "<EOA address>", "address_to": "<recipient>", "amount": 50, "symbol": "USDT" } // 4. Проверить статус по traceId POST /api/wallet/gasfree/status { "trace_id": "<traceId из ответа>" }
Переменные окружения (на сервере)
ПеременнаяОписание
GASFREE_API_KEYAPI ключ из кабинета GasFree Developers Center
GASFREE_API_SECRETСекрет из кабинета GasFree
GASFREE_ENV"mainnet" (по умолч.) или "testnet"
HTTP кодОписание
200Успех
400Bad Request — неверные параметры
401Unauthorized — токен отсутствует или недействителен
404Not Found — эндпоинт не найден
405Method Not Allowed — неверный HTTP метод
500Internal Server Error
Формат ошибок
{ "error": "Описание ошибки" }
01 Регистрация / Вход
curl -X POST https://your-domain.com/api/register \ -H "Content-Type: application/json" \ -d '{"unique_hash": "my_super_secret_code_minimum_20chars"}'
02 Создать кошелёк (TRON)
curl -X POST https://your-domain.com/api/wallet/create \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d '{"node": "TRON"}'
03 Список кошельков
curl -X POST https://your-domain.com/api/wallets \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d '{"node": "TRON"}'
04 Баланс кошелька
curl -X POST https://your-domain.com/api/wallet/balance \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d '{"node": "ETH", "address": "0x742d35Cc6634C0532925a3b8..."}'
05 Перевод средств
curl -X POST https://your-domain.com/api/wallet/transfer \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d '{ "node": "TRON", "address_from": "TXyz123...", "address_to": "TAbc456...", "amount": 10, "symbol": "TRX" }'
06 GasFree USDT перевод (TRON)
curl -X POST https://your-domain.com/api/wallet/transfer \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d '{ "node": "TRON", "mode": "gasfree", "address_from": "TXyz123...", "address_to": "TAbc456...", "amount": 50, "symbol": "USDT" }'
07 Статус GasFree перевода
curl -X POST https://your-domain.com/api/wallet/gasfree/status \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_TOKEN" \ -d '{"trace_id": "unique-trace-id-123"}'
setup Базовый клиент
<?php define('API_BASE', 'https://your-domain.com'); define('API_TOKEN', 'YOUR_TOKEN'); // После регистрации function apiRequest(string $path, array $body = [], bool $auth = true): array { $headers = ['Content-Type: application/json']; if ($auth) { $headers[] = 'Authorization: Bearer ' . API_TOKEN; } $ch = curl_init(API_BASE . $path); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode($body), CURLOPT_HTTPHEADER => $headers, CURLOPT_TIMEOUT => 30, ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); return ['code' => $httpCode, 'data' => json_decode($response, true)]; }
01 Регистрация / Вход
$result = apiRequest('/api/register', [ 'unique_hash' => 'my_super_secret_code_minimum_20chars' ], false); if ($result['data']['token'] ?? false) { $token = $result['data']['token']; echo "Токен: $token\n"; } else { echo "Ошибка: " . ($result['data']['error'] ?? 'unknown') . "\n"; }
02 Создать кошелёк
// Создать TRON кошелёк $result = apiRequest('/api/wallet/create', ['node' => 'TRON']); $wallet = $result['data']; echo "Адрес: " . $wallet['address'] . "\n"; echo "Приватный ключ: " . $wallet['private_key'] . "\n"; // Создать ETH кошелёк $ethWallet = apiRequest('/api/wallet/create', ['node' => 'ETH'])['data']; echo "ETH адрес: " . $ethWallet['address'] . "\n"; // Создать GasFree TRON кошелёк (без TRX на газ) $gfWallet = apiRequest('/api/wallet/create', [ 'node' => 'TRON', 'mode' => 'gasfree' ])['data']; echo "GasFree адрес: " . $gfWallet['gasfree_address'] . "\n";
03 Список кошельков
// Все кошельки $result = apiRequest('/api/wallets'); foreach ($result['data']['list'] ?? [] as $w) { echo "[{$w['node_name']}] {$w['address']}\n"; } // Только TRON кошельки $tronWallets = apiRequest('/api/wallets', ['node' => 'TRON'])['data']; // Только GasFree кошельки $gfWallets = apiRequest('/api/wallets', [ 'node' => 'TRON', 'mode' => 'gasfree' ])['data'];
04 Баланс кошелька
$result = apiRequest('/api/wallet/balance', [ 'node' => 'TRON', 'address' => 'TXyz123...' ]); foreach ($result['data']['balances'] ?? [] as $b) { echo "{$b['symbol']}: {$b['balance']}\n"; } // ETH баланс $ethBalance = apiRequest('/api/wallet/balance', [ 'node' => 'ETH', 'address' => '0x742d35Cc6634...' ])['data'];
05 Перевод средств
// Перевод TRX $result = apiRequest('/api/wallet/transfer', [ 'node' => 'TRON', 'address_from' => 'TXyz123...', 'address_to' => 'TAbc456...', 'amount' => 10, 'symbol' => 'TRX' ]); echo "TXID: " . $result['data']['data']['txid'] . "\n"; // Перевод USDT (стандартный) $usdtResult = apiRequest('/api/wallet/transfer', [ 'node' => 'TRON', 'address_from' => 'TXyz123...', 'address_to' => 'TAbc456...', 'amount' => 25.5, 'symbol' => 'USDT' ]);
06 GasFree USDT перевод
$result = apiRequest('/api/wallet/transfer', [ 'node' => 'TRON', 'mode' => 'gasfree', 'address_from' => 'TXyz123...', // EOA адрес 'address_to' => 'TAbc456...', 'amount' => 50, 'symbol' => 'USDT' // Только USDT ]); $traceId = $result['data']['data']['traceId']; echo "Trace ID: $traceId\n"; // Проверить статус $status = apiRequest('/api/wallet/gasfree/status', [ 'trace_id' => $traceId ]); echo "Статус: " . $status['data']['data']['status'] . "\n";
07 Комиссии GasFree
$fees = apiRequest('/api/wallet/gasfree/fees')['data']; echo "Перевод: " . $fees['data']['transfer_fee'] . " USDT\n"; echo "Активация: " . $fees['data']['activation_fee'] . " USDT\n";
setup Базовый клиент (axios)
// npm install axios const axios = require('axios'); const API_BASE = 'https://your-domain.com'; const API_TOKEN = 'YOUR_TOKEN'; // После регистрации const api = axios.create({ baseURL: API_BASE, headers: { 'Content-Type': 'application/json' }, }); // Авторизованный запрос async function apiPost(path, body = {}, auth = true) { const headers = auth ? { Authorization: `Bearer ${API_TOKEN}` } : {}; const { data } = await api.post(path, body, { headers }); return data; }
01 Регистрация / Вход
const result = await apiPost('/api/register', { unique_hash: 'my_super_secret_code_minimum_20chars' }, false); const token = result.token; console.log('Токен:', token);
02 Создать кошелёк
// TRON const tronWallet = await apiPost('/api/wallet/create', { node: 'TRON' }); console.log('Адрес:', tronWallet.address); console.log('Приватный ключ:', tronWallet.private_key); // ETH / BSC / Polygon — меняем только node const ethWallet = await apiPost('/api/wallet/create', { node: 'ETH' }); const bscWallet = await apiPost('/api/wallet/create', { node: 'BSC' }); const solWallet = await apiPost('/api/wallet/create', { node: 'SOLANA' }); // GasFree кошелёк (TRON без газа в TRX) const gfWallet = await apiPost('/api/wallet/create', { node: 'TRON', mode: 'gasfree' }); console.log('GasFree адрес:', gfWallet.gasfree_address);
03 Список кошельков
// Все кошельки const all = await apiPost('/api/wallets'); all.list.forEach(w => console.log(`[${w.node_name}] ${w.address}`)); // Только TRON const tron = await apiPost('/api/wallets', { node: 'TRON' }); // GasFree кошельки const gasfree = await apiPost('/api/wallets', { node: 'TRON', mode: 'gasfree' });
04 Баланс кошелька
const result = await apiPost('/api/wallet/balance', { node: 'TRON', address: 'TXyz123...' }); result.balances.forEach(b => { console.log(`${b.symbol}: ${b.balance}`); }); // ETH const ethBal = await apiPost('/api/wallet/balance', { node: 'ETH', address: '0x742d35Cc6634...' });
05 Перевод средств
// TRX перевод const txResult = await apiPost('/api/wallet/transfer', { node: 'TRON', address_from: 'TXyz123...', address_to: 'TAbc456...', amount: 10, symbol: 'TRX' }); console.log('TXID:', txResult.data.txid); // BNB на BSC const bnbTx = await apiPost('/api/wallet/transfer', { node: 'BSC', address_from: '0xSender...', address_to: '0xRecipient...', amount: 0.5, symbol: 'BNB' });
06 GasFree USDT перевод
const result = await apiPost('/api/wallet/transfer', { node: 'TRON', mode: 'gasfree', address_from: 'TXyz123...', // EOA адрес address_to: 'TAbc456...', amount: 50, symbol: 'USDT' // только USDT }); const { traceId } = result.data; console.log('Trace ID:', traceId); // Ждём и проверяем статус const status = await apiPost('/api/wallet/gasfree/status', { trace_id: traceId }); console.log('Статус:', status.data.status);
07 Комиссии GasFree
const fees = await apiPost('/api/wallet/gasfree/fees'); console.log(`Перевод: ${fees.data.transfer_fee} USDT`); console.log(`Активация: ${fees.data.activation_fee} USDT`);
setup Базовый клиент (fetch)
const API_BASE = 'https://your-domain.com'; let API_TOKEN = ''; // Установить после регистрации async function apiPost(path, body = {}, auth = true) { const headers = { 'Content-Type': 'application/json' }; if (auth) headers['Authorization'] = `Bearer ${API_TOKEN}`; const res = await fetch(API_BASE + path, { method: 'POST', headers, body: JSON.stringify(body), }); if (!res.ok) { const err = await res.json(); throw new Error(err.error || `HTTP ${res.status}`); } return res.json(); }
01 Регистрация / Вход
const result = await apiPost('/api/register', { unique_hash: 'my_super_secret_code_minimum_20chars' }, false); API_TOKEN = result.token; // Сохраняем токен console.log('Токен:', API_TOKEN);
02 Создать кошелёк
// TRON кошелёк const wallet = await apiPost('/api/wallet/create', { node: 'TRON' }); console.log('Адрес:', wallet.address); // Несколько сетей параллельно const [tron, eth, bsc, sol] = await Promise.all([ apiPost('/api/wallet/create', { node: 'TRON' }), apiPost('/api/wallet/create', { node: 'ETH' }), apiPost('/api/wallet/create', { node: 'BSC' }), apiPost('/api/wallet/create', { node: 'SOLANA' }), ]); // GasFree (TRON, без газа в TRX) const gfWallet = await apiPost('/api/wallet/create', { node: 'TRON', mode: 'gasfree' });
03 Список кошельков
const { list } = await apiPost('/api/wallets'); list.forEach(w => console.log(`[${w.node_name}] ${w.address}`)); // Фильтр по сети const tronWallets = await apiPost('/api/wallets', { node: 'TRON' }); // GasFree кошельки const gfWallets = await apiPost('/api/wallets', { node: 'TRON', mode: 'gasfree' });
04 Баланс кошелька
const { balances } = await apiPost('/api/wallet/balance', { node: 'TRON', address: 'TXyz123...' }); balances.forEach(b => console.log(`${b.symbol}: ${b.balance}`));
05 Перевод средств
const result = await apiPost('/api/wallet/transfer', { node: 'TRON', address_from: 'TXyz123...', address_to: 'TAbc456...', amount: 10, symbol: 'TRX' }); console.log('TXID:', result.data.txid); console.log('Комиссия:', result.data.commission);
06 GasFree USDT перевод
const result = await apiPost('/api/wallet/transfer', { node: 'TRON', mode: 'gasfree', address_from: 'TXyz123...', address_to: 'TAbc456...', amount: 50, symbol: 'USDT' }); const traceId = result.data.traceId; // Проверка статуса const status = await apiPost('/api/wallet/gasfree/status', { trace_id: traceId }); console.log('Статус:', status.data.status); console.log('TX Hash:', status.data.txHash);
07 Комиссии GasFree
const { data } = await apiPost('/api/wallet/gasfree/fees'); console.log(`Перевод: ${data.transfer_fee} USDT`); console.log(`Активация: ${data.activation_fee} USDT`);
setup Базовый клиент (requests)
# pip install requests import requests API_BASE = 'https://your-domain.com' API_TOKEN = 'YOUR_TOKEN' # После регистрации def api_post(path: str, body: dict = {}, auth: bool = True) -> dict: headers = {'Content-Type': 'application/json'} if auth: headers['Authorization'] = f'Bearer {API_TOKEN}' resp = requests.post( API_BASE + path, json=body, headers=headers, timeout=30 ) resp.raise_for_status() return resp.json()
01 Регистрация / Вход
result = api_post('/api/register', { 'unique_hash': 'my_super_secret_code_minimum_20chars' }, auth=False) token = result['token'] print(f'Токен: {token}')
02 Создать кошелёк
# TRON кошелёк wallet = api_post('/api/wallet/create', {'node': 'TRON'}) print(f"Адрес: {wallet['address']}") print(f"Приватный ключ: {wallet['private_key']}") # ETH / BSC / Polygon — меняем node eth_wallet = api_post('/api/wallet/create', {'node': 'ETH'}) bsc_wallet = api_post('/api/wallet/create', {'node': 'BSC'}) sol_wallet = api_post('/api/wallet/create', {'node': 'SOLANA'}) ton_wallet = api_post('/api/wallet/create', {'node': 'TON'}) # GasFree кошелёк (TRON без TRX для газа) gf_wallet = api_post('/api/wallet/create', { 'node': 'TRON', 'mode': 'gasfree' }) print(f"GasFree адрес: {gf_wallet['gasfree_address']}")
03 Список кошельков
# Все кошельки result = api_post('/api/wallets') for w in result.get('list', []): print(f"[{w['node_name']}] {w['address']}") # Только TRON tron_wallets = api_post('/api/wallets', {'node': 'TRON'}) # GasFree кошельки gf_wallets = api_post('/api/wallets', { 'node': 'TRON', 'mode': 'gasfree' })
04 Баланс кошелька
result = api_post('/api/wallet/balance', { 'node': 'TRON', 'address': 'TXyz123...' }) for b in result.get('balances', []): print(f"{b['symbol']}: {b['balance']}") # ETH баланс eth_bal = api_post('/api/wallet/balance', { 'node': 'ETH', 'address': '0x742d35Cc6634...' })
05 Перевод средств
# Перевод TRX result = api_post('/api/wallet/transfer', { 'node': 'TRON', 'address_from': 'TXyz123...', 'address_to': 'TAbc456...', 'amount': 10, 'symbol': 'TRX' }) print(f"TXID: {result['data']['txid']}") # Перевод BNB на BSC bnb_result = api_post('/api/wallet/transfer', { 'node': 'BSC', 'address_from': '0xSender...', 'address_to': '0xRecipient...', 'amount': 0.5, 'symbol': 'BNB' })
06 GasFree USDT перевод
result = api_post('/api/wallet/transfer', { 'node': 'TRON', 'mode': 'gasfree', 'address_from': 'TXyz123...', # EOA адрес 'address_to': 'TAbc456...', 'amount': 50, 'symbol': 'USDT' # только USDT }) trace_id = result['data']['traceId'] print(f'Trace ID: {trace_id}') # Проверить статус status = api_post('/api/wallet/gasfree/status', { 'trace_id': trace_id }) print(f"Статус: {status['data']['status']}")
07 Комиссии GasFree
fees = api_post('/api/wallet/gasfree/fees') data = fees['data'] print(f"Перевод: {data['transfer_fee']} USDT") print(f"Активация: {data['activation_fee']} USDT")