Моніторинг: для обмінників

Для операторів обмінників: фід, частота, підключення

Як виглядає стандартний файл

Приклад нижче — вигаданий: коди валют і структура як у стандарті для моніторингів (BestChange EREF v1.1, ті самі поля читають більшість моніторингів), числа — довільні, не ринкові курси. Читаємо також v1.0 (minamount/maxamount) і варіант з одиницями в лімітах (50 USDT).

<?xml version="1.0" encoding="UTF-8"?>
<rates>
  <item>
    <from>USDTTRC20</from>
    <to>P24UAH</to>
    <in>1</in>
    <out>41.25</out>
    <amount>1500000</amount>
    <frommin>50</frommin>
    <frommax>20000</frommax>
    <fromfee>1</fromfee>
    <tofee>0.5%</tofee>
    <manual/>
  </item>
  <item>
    <from>BTC</from>
    <to>MONOBUAH</to>
    <in>1</in>
    <out>2650000</out>
    <amount>900000</amount>
    <frommin>0.001</frommin>
    <frommax>2</frommax>
  </item>
  <item>
    <from>USDTTRC20</from>
    <to>CASHUSD</to>
    <in>1.01</in>
    <out>1</out>
    <amount>200000</amount>
    <city>KIEV,LVOV</city>
  </item>
</rates>

Той самий набір полів у JSON:

{
  "version": 1,
  "rates": [
    {"from": "USDTTRC20", "to": "P24UAH", "in": 1, "out": 41.25, "amount": 1500000,
     "frommin": 50, "frommax": 20000, "fromfee": "1%", "manual": true},
    {"from": "BTC", "to": "MONOBUAH", "in": 1, "out": 2650000, "amount": 900000,
     "frommin": 0.001, "frommax": 2}
  ]
}

Що ми читаємо

• from, to — коди напрямку (як у стандарті: USDTTRC20, BTC, P24UAH, MONOBUAH, CARDUAH, CASHUSD…); невідомі коди і рублеві напрямки пропускаємо.
• in, out — курс: за in одиниць «from» клієнт отримує out одиниць «to».
• amount — резерв у валюті «to»; 0 — напрямок тимчасово прихований.
• frommin/frommax (або minamount/maxamount), fromfee/tofee — числом або у відсотках.
• city — для готівки (коди міст через кому); міста на окупованих територіях не показуємо.
• Прапорці умов (manual, verifying, cardverify…) — окремими тегами або в param.

Частота опитування

На старті опитуємо кожен фід раз на 15 хвилин. Рядок, який не оновлювався довше за 45 хвилин, показуємо сірим з позначкою «дані застаріли» і не порівнюємо з іншими. Час оновлення біля кожного курсу — чесний: «оновлено N хв тому».

Потрібно частіше? Після навантажувального тесту на сотні фідів ми зможемо опитувати фіди обмінників, які про це попросять, раз на 1–5 хвилин. Напишіть через форму «Оновити фід або дані» на сторінці вашого обмінника. Опитування раз на кілька секунд не плануємо: ми не проводимо обмін, а остаточний курс клієнт однаково бачить на вашому сайті.

Білий список і закритий фід

• Додайте User-Agent my-banks.info-monitor/1.0 (+https://my-banks.info/monitoring) у білий список антибот-захисту; IP-адреси робота опублікуємо тут після запуску. Капчу і JS-перевірки робот не проходить і не обходить.
• Закритий фід: передайте токен через форму підключення. Токен не зберігаємо в базі даних і не пишемо в журнали — він зашифрованим чекає на редактора і переходить у налаштування робота. Краще — окремий токен лише для читання фіду.

Premium Exchanger 2.1: як увімкнути файл курсів

Стандартний XML-експорт рушія Premium Exchanger 2.1 ми читаємо як rates.xml без додаткових налаштувань: ліміти з кодом валюти (100 USDT), комісії списком (10 UAH, 1.5 %), окремий запис на кожне місто, прапорці в param (manual, juridical, verifying, hold). TXT-експорт не приймаємо — у ньому немає лімітів, комісій і міст; JSON-експорту у версії 2.1 немає.

1. Адмінка WordPress → «Настройки обменника» → «Настройки TXT и XML экспорта»: увімкніть XML.
2. Адреса файлу: https://<сайт>/request-exportxml.xml (режим фізичних файлів — /premium_request-exportxml.php, застарілий — /exportxml.xml). Якщо увімкнено персональний хеш, надішліть нам повну адресу з ?hcron=… через форму підключення: без хешу рушій віддає <error>.
3. Режим «статичний файл» кращий: файл перебудовується за подіями, а сервер відповідає 304 на наш умовний запит. У динамічному режимі файл будується на кожен запит — це теж працює.
4. Коди валют — поле «XML-ім’я» в картці валюти: коди BestChange (USDTTRC20, P24UAH, MONOBUAH, CASHUAH, BTC…). Старі коди USDTERC читаємо як USDTERC20, DSH — як DASH; USDT без мережі не приймаємо. Міста готівки — поле xml_city (KIEV, LVOV, ODS…), кілька — через кому.
5. Дозвольте шлях до файлу в robots.txt для нашого робота і додайте його User-Agent у білий список DDoS-захисту.

Як ми обробляємо файл: <error>Maintenance</error> з HTTP 200 — це технічні роботи: курси не оновлюємо, і з часом рядки отримують позначку «дані застаріли»; BOM і порожні рядки перед заголовком XML пропускаємо; від’ємний резерв вважаємо нулем (напрямок неактивний); рядок з нульовим курсом відкидаємо; порожній <rates> — усі напрямки неактивні.

Як зняти обмінник з моніторингу

Форма «Оновити фід або дані» на сторінці обмінника з позначкою «зняти з моніторингу», або заборона шляху фіду в robots.txt. Після відкликання згоди курси зникають з видачі, а сторінка в каталозі показує «Моніторинг призупинено» або «Фід не підключено».