API დოკუმენტაცია

რეალურ დროში WebSocket API USDT/USDC ბანის მოვლენების მონიტორინგისთვის Tron და Ethereum ქსელებზე.

დაწყება

დაუკავშირდით WebSocket ენდპოინტს ბანის მოვლენების რეალურ დროში მისაღებად და მისამართების შესახებ ინფორმაციის მოსათხოვად.

WebSocket ენდპოინტი
wss://api.usdtbanlist.com/ws?apiKey=YOUR_API_KEY
💡

მიიღეთ API გასაღები

გახსენით @USDTBanBot Telegram-ში, გადადით პროფილში → API Key გასაღების გენერაციისთვის.

ავთენტიფიკაცია

ჩასვით API გასაღები კავშირის URL-ში ან გაგზავნეთ auth შეტყობინება დაკავშირების შემდეგ.

ვარიანტი 1: URL პარამეტრი (რეკომენდებული)
wss://api.usdtbanlist.com/ws?apiKey=mk_your_api_key_here
ვარიანტი 2: Auth შეტყობინება
{
  "type": "auth",
  "apiKey": "mk_your_api_key_here"
}
კავშირის პასუხი
{
  "type": "connected",
  "clientId": "client_xxx",
  "authenticated": true,
  "tier": "free"  // or "premium"
}

მოვლენები

დაკავშირებისა და ავთენტიფიკაციის შემდეგ, მიიღებთ ბანის მოვლენებს რეალურ დროში.

მოვლენის ტიპიაღწერატარიფი
ban_submittedბანი ელოდება დადასტურებას მულტისიგშიპრემიუმ
ban_executedმისამართი დაბანილია (დადასტურებული)უფასო
unban_submittedბანის მოხსნა ელოდება დადასტურებას მულტისიგშიპრემიუმ
unban_executedმისამართს ბანი მოეხსნაუფასო
destroy_submittedსახსრების დაწვა ელოდება დადასტურებას მულტისიგშიპრემიუმ
destroy_executedსახსრები დაიწვა დაბანილი მისამართიდანუფასო
მოვლენის შეტყობინების ფორმატი
{
  "type": "event",
  "event": {
    "id": "uuid",
    "network": "trx",           // "trx" or "eth"
    "eventType": "ban_executed",
    "address": "41...",         // hex format
    "addressBase58": "T...",    // TRX only
    "symbol": "USDT",
    "txHash": "...",
    "blockNumber": 12345678,
    "timestamp": "2024-01-15T12:00:00Z",
    "amount": "1234.56",        // balance at event time
    "amountRaw": "1234560000"
  }
}

JSON-RPC მეთოდები

გაგზავნეთ JSON-RPC 2.0 მოთხოვნები მონაცემების მოსათხოვად და გამოწერების სამართავად.

ping

კავშირის ჯანმრთელობის შემოწმება

მოთხოვნა
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "ping"
}
პასუხი
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "pong"
}
getStatus

მიმდინარე კავშირის სტატუსისა და ლიმიტების ინფორმაციის მიღება

მოთხოვნა
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getStatus"
}
პასუხი
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tier": "free",
    "subscriptions": ["all"],
    "rateLimit": {
      "used": 5,
      "limit": 10,
      "windowMs": 60000
    }
  }
}
subscribe

მოვლენების არხებზე გამოწერა

მოთხოვნა
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "subscribe",
  "params": {
    "channels": ["all"]  // "all", "eth", "trx", or address
  }
}
პასუხი
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "subscribed": ["all"],
    "total": 1
  }
}
unsubscribe

არხებიდან გამოწერის გაუქმება

მოთხოვნა
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "unsubscribe",
  "params": {
    "channels": ["eth"]  // empty array to unsubscribe all
  }
}
პასუხი
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "unsubscribed": ["eth"],
    "remaining": 1
  }
}
checkAddress

შემოწმება, დაბანილია თუ არა მისამართი

მოთხოვნა
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "checkAddress",
  "params": {
    "address": "TLJpijVuVyjAtKRahhGTAFkpZxfpzHMtWe"
  }
}
პასუხი
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "address": "TLJpijVuVyjAtKRahhGTAFkpZxfpzHMtWe",
    "network": "trx",
    "isBanned": false,
    "usdt_status": "active",
    "usdc_status": "active",
    "usdt_balance": "0.00",
    "usdc_balance": "0.00",
    "tag": { "type": "GasFree", "tag": "GasFree" },
    "events": [{ "event_name": "UnBlock", "volume": "0.00", "symbol": "USDT", "status": "executed" }],
    "walletScore": { "totalScore": 45, "riskLevel": "medium" },
    "connections": { "totalConnections": 0, "categories": [] },
    "formattedText": "..."
  }
}
getAddressInfo

მისამართის შესახებ დეტალური ინფორმაციის მიღება

მოთხოვნა
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getAddressInfo",
  "params": {
    "address": "TLJpijVuVyjAtKRahhGTAFkpZxfpzHMtWe",
    "network": "trx"
  }
}
პასუხი
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "address": "TLJpijVuVyjAtKRahhGTAFkpZxfpzHMtWe",
    "network": "trx",
    "info": {
      "label": "Exchange Wallet",
      "firstSeen": "2023-01-15T10:00:00Z",
      "lastSeen": "2024-01-10T15:30:00Z"
    },
    "cached": true
  }
}

მოთხოვნების ლიმიტები

ტარიფიRPC მოთხოვნებიმოვლენები
უფასო10 / წუთშიმხოლოდ შესრულებული
პრემიუმ100 / წუთშიყველა მოვლენა (მოლოდინში + შესრულებული)

მოთხოვნების ლიმიტის გადაჭარბებისას მიიღებთ შეცდომის პასუხს:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "Rate limit exceeded"
  }
}

მაგალითები

JavaScript / Node.js
example.js
const WebSocket = require('ws');

const API_KEY = 'mk_your_api_key';
const ws = new WebSocket(`wss://api.usdtbanlist.com/ws?apiKey=${API_KEY}`);

ws.on('open', () => {
  console.log('Connected');

  // Subscribe to TRX events
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'subscribe',
    params: { channels: ['trx'] }
  }));
});

ws.on('message', (data) => {
  const msg = JSON.parse(data);

  if (msg.type === 'event') {
    console.log('Ban event:', msg.event.eventType, msg.event.address);
  }

  if (msg.jsonrpc) {
    console.log('RPC response:', msg);
  }
});

ws.on('error', console.error);
Python
example.py
import json
import websocket

API_KEY = 'mk_your_api_key'

def on_message(ws, message):
    msg = json.loads(message)

    if msg.get('type') == 'event':
        event = msg['event']
        print(f"Ban event: {event['eventType']} - {event['address']}")

    if msg.get('type') == 'connected' and msg.get('authenticated'):
        # Subscribe to all events
        ws.send(json.dumps({
            'jsonrpc': '2.0',
            'id': 1,
            'method': 'subscribe',
            'params': {'channels': ['all']}
        }))

def on_error(ws, error):
    print(f"Error: {error}")

ws = websocket.WebSocketApp(
    f"wss://api.usdtbanlist.com/ws?apiKey={API_KEY}",
    on_message=on_message,
    on_error=on_error
)

ws.run_forever()

დახმარება გჭირდებათ?

დაგვიკავშირდით Telegram-ში მხარდაჭერის ან ფუნქციის მოთხოვნისთვის.

მხარდაჭერასთან დაკავშირება
API დოკუმენტაცია — USDT Ban List