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

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

Как выглядит стандартный файл

Пример ниже — вымышленный: коды валют и структура как в стандарте для мониторингов (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. После отзыва согласия курсы исчезают из выдачи, а страница в каталоге показывает «Мониторинг приостановлен» или «Фид не подключён».