EMpulse Street FX Index: методыка
EMpulse Street FX Index штодня публікуе «вулічныя» абменныя курсы валют краін, якія развіваюцца, да USDT (прымаецца за 1 USD): курс, па якім людзі плацяць насамрэч, а не афіцыйны. Індэкс аб'ядноўвае рынкавыя даныя на аснове транзакцый з коціроўкамі з публічных рынкавых крыніц; кожны шэраг мае клас упэўненасці, а межы даных публікуюцца разам з ім.
Складнікі
| складнік | што гэта | дзе паказваецца |
|---|---|---|
| на аснове транзакцый | узважанае сярэдняе рынкавых транзакцый за дзень па кожнай валюце і баку рынку. У індэкс трапляюць толькі агрэгаты: асобныя транзакцыі і іх удзельнікі не захоўваюцца і не публікуюцца | GET /v1/rates/*, актуальная табліца |
| мультыкрынічны | каціроўкі курсаў, якія публікуюць незалежныя рынкавыя крыніцы (публічныя каналы абменнікаў, раздзелы з курсамі ў мясцовых выданнях, форумы), з вагамі паводле надзейнасці, якую кожная крыніца заслужыла | GET /v1/street-index/* (прадукт «Street Rate Index - мультыкрынічны»); актуальная табліца для валют, якія індэкс пакрывае толькі праз публічныя крыніцы |
| біржавы | адкрытыя кнігі заявак крыптабіржаў, дзе лічбавы долар каціруецца да валюты; яны счытваюцца раз на гадзіну праз дакументаваныя публічныя API біржаў: лепшыя прапановы кожнага боку, іх цэны і сума ў прапанове, агрэгаваныя па кожнай біржы і па ўсіх біржах з надзейнасцю, якую заслужыла кожная біржа. Кожная біржа лічыцца адной крыніцай; назвы да лічбаў не дадаюцца | актуальная табліца і GET /v1/rates/* для валют, якія індэкс пакрывае праз біржы; exchange_spread_pct (Pro); знешні складнік USDT Liquidity |
Усе курсы каціруюцца як фіят за 1 USDT.
Біржавы складнік
- Якія біржы. Толькі біржы, якія публікуюць дакументаванае публічнае API для сваіх прапаноў, даступнае для
чытання без уліковага запісу, умовы якіх не забараняюць аўтаматычнае счытванне або распаўсюд і чый
robots.txtдазваляе гэты эндпойнт. Усё астатняе выключаецца, а ўмовы кожнай біржы перачытваюцца кожныя 30 дзён: біржа, чые ўмовы змяніліся, выбывае самастойна. Біржы за лічбай паказваюцца толькі як колькасць (sources); спіс біржаў публікуецца тут з іх згоды і ў іншым выпадку да лічбаў не далучаецца. - Гадзіна. Для кожнай біржы, валюты і боку лепшыя прапановы па цане (да 20) даюць лепшую цану, медыяну,
цану, узважаную па глыбіні, і глыбіню (сума ў прапанове, у USDT). Бакі адпавядаюць канвенцыі індэкса:
buy- гэта бок, дзе кліент купляе лічбавы долар. Біржа, якая каціруе біткоін, а не доларавы токен, уваходзіць праз сваю кнігу ў доларах ЗША за тую ж гадзіну (цана ў валюце ÷ цана ў доларах), таму кожная лічба з'яўляецца доларавым курсам. Па ўсіх біржахmid,buyіsellза гадзіну - гэта медыяны, узважаныя па надзейнасці;exchange_spread_pct= (найвышэйшы − найніжэйшы mid біржы) / медыяна × 100 пры наяўнасці не менш за дзве біржы. За дзень бяруцца медыяны яго гадзін. - Надзейнасць біржы (0–1, пералічваецца штодня за 30 дзён): дакладнасць =
max(0, 1 − dev / 5 %),dev= медыянная адлегласць mid біржы ад медыяны астатніх біржаў за тую ж гадзіну (калі астатніх менш за дзве, ад эталона на аснове транзакцый за дзень); складнік глыбіні (глыбіня адносна нормы) і складнік свежасці (гадзіны з данымі за апошнія суткі);0.5·accuracy + 0.25·depth + 0.25·freshness. Біржа, цэны якой адрозніваюцца ад іншых (састарэлая або маніпуляваная кніга), адразу губляе вагу; тры штодзённыя ацэнкі ніжэй за 0.2 прыпыняюць яе на тыдзень. - Упэўненасць. Дзень мае клас
highпры наяўнасці не менш за тры біржы ў межах 2 % адна ад адной,mediumпры не менш за тры біржы,limitedпры меншай колькасці. Дзень трапляе ў адзіны публічны індэкс валюты паводле правіла ніжэй; валюта, якую каціруюць біржы і якую не пакрывае ніводны іншы складнік, становіцца актыўнай праз гэты складнік.
Пакрыццё і актыўнасць
Індэкс валюты - гэта адна лічба за дзень, пабудаваная з прыведзеных вышэй складнікаў:
- калі публікуе толькі адзін складнік, індэксам з'яўляецца гэты складнік;
- калі публікуюць некалькі, перамагае найсвежы дзень; складнікі, якія публікуюць за той самы дзень, усярэдніваюцца з
вагамі паводле ўпэўненасці: складнік на аснове транзакцый з вагой 1 / 0.6 / 0.3 для дня
high/medium/limited, мультыкрынічны і біржавы складнікі з іх ацэнкай упэўненасці (0–1, не менш за 0.1).
Валюта актыўная, калі ў індэкса ёсць дзень у межах апошніх 14 дзён (/v1/currencies: status =
"active", active_since = першы дзень бягучай серыі даных без перапынку даўжэй за 14 дзён). Валюта
без свежага дня - гэта пакрыццё ў працэсе: мы дадаем для яе рынкавыя крыніцы, яе апублікаваная
гісторыя застаецца даступнай, і яна вяртаецца ў спіс актыўных сама, як толькі з'явіцца свежы дзень. Актуальная табліца
сайта паказвае толькі актыўныя валюты; колькасць валют, названая ў планах, - гэта колькасць актыўных
валют.
Для кожнай актыўнай валюты апошні дзень змяшчае:
- sources - колькасць незалежных рынкавых крыніц за днём (складнік на аснове транзакцый лічыцца
за адну, кожная біржа біржавога складніка - за адну). Яна публікуецца, калі роўная двум або больш,
і заўсёды для дня
limited(«1 крыніца, абмежаваная ўпэўненасць»); інакш яна пустая (nullу API). - confidence - клас апошняга дня (
high/medium/limited, гл. ніжэй); калі дню тры або больш дзён, ён паказваецца на клас ніжэй.
Валюта публікуецца ўжо з першай рынкавай крыніцы: дзень з адной крыніцай мае клас limited і
пазнаку coverage improving (сайт, API, MCP): лічба рэальная, яе нявызначанасць пазначана, і крыніцы
дадаюцца. medium патрабуе дзвюх незалежных крыніц, high - трох, якія супадаюць у межах 2 %. Біржавы
складнік уваходзіць у правіла актыўнасці, толькі калі яго кнігі заявак паказваюць не менш за тры незалежныя прапановы за гадзіну
і даныя за два дні; валюта без адной кропкі даных застаецца coverage_in_progress.
Штодзённыя палі індэкса (GET /v1/rates/{cur})
- buy - узважаны сярэдні курс за дзень, па якім кліент купляе USDT за фіят. Бок з занадта малой колькасцю кропак
даных за дзень мае значэнне
null. - sell - тое самае для боку, дзе кліент прадае USDT.
- mid -
(buy + sell) / 2, калі існуюць іbuy, іsell. Калі існуе толькі адзін бок рынку,midроўны курсу гэтага боку (гл.side). Калі няма ніводнага боку,midроўныnull. - side - на чым заснаваны
mid:both,buy(існуе толькіbuy) абоsell(існуе толькіsell);null, каліmidняма.mid, заснаваны на адным баку рынку, зрушаны прыблізна на палову спрэду адносна двухбаковага, таму ўлічвайцеsideпры параўнанні дзён. - spread_pct -
(buy − sell) / mid × 100, толькі прыside = "both"; інакшnull. Звычайна ён дадатны; адмоўны спрэд можа ўзнікаць у дні з абмежаванымі данымі і публікуецца як ёсць. - confidence -
high,mediumабоlimited. Кожная валюта мае базавы клас паводле пакрыцця (GET /v1/currencies:highдля найлепш пакрытага шэрагу,mediumдля астатніх); дзень з меншай колькасцю кропак даных, чым звычайна, мае клас на адзін ніжэй (high → medium,medium → limited).limitedазначае менш кропак даных: больш шуму, магчымыя прабелы. - in_progress -
trueдля апошняга дня валюты, пакуль дзень яшчэ збіраецца і колькасць яго кропак даных выразна ніжэй за норму папярэдніх 7 каляндарных дзён (толькі дні з данымі). Такі дзень будзе перагледжаны. Усе астатнія дні маюцьfalse. - mid_7d - арыфметычнае сярэдняе карэктных значэнняў
midза апошнія 7 каляндарных дзён, уключаючы сам дзень. Дні без карэктнагаmidпрапускаюцца;null, калі іх няма. -
chg_1d_pct, chg_7d_pct, chg_30d_pct -
(mid / mid_N_days_ago − 1) × 100, параўнанне роўна з 1, 7 або 30 каляндарнымі днямі раней.null, калі ў любога з двух дзён няма карэктнагаmid(без пераносу наперад праз прабелы) або калі ў двух дзён розныside(напрыклад,bothсупрацьbuy): аднабаковыmidзрушаны прыблізна на палову спрэду, таму такое параўнанне паказала б рух, якога не было. -
exchange_spread_pct (Pro і Enterprise) - міжбіржавы спрэд біржавога складніка за дзень (гл. вышэй);
nullпры менш чым дзвюх біржах.
«Карэктны mid» - гэта mid, які не роўны null і не пазначаны як выкід.
Бок, які не рухаецца
Часам адзін бок рынку перастае рухацца, а другі працягвае гандлявацца па зменлівых коштах: на працягу некалькіх дзён
(для дзённага індэкса пяці) медыянны курс гэтага боку застаецца ў межах 0.05 %, або кожны дзень на гэтым баку закрываецца па адзінай
цане. Такая цана абвяшчаецца, а не рэалізуецца ў гандлі, і mid дакладна пасярэдзіне паміж ёй і жывым бокам
не меў бы сэнсу. У такім выпадку індэкс будуецца толькі па баку, які рухаецца: mid роўны курсу гэтага боку, side называе
яго (buy або sell), хоць публікуюцца і buy, і sell, а spread_pct роўны null. Правіла прымяняецца
дзень за днём і знімаецца сама, як толькі спакойны бок зноў пачынае рухацца; калі абодва бакі аднолькава нерухомыя (плоскі
рынак), нічога не змяняецца. Гадзінны індэкс прымяняе тое самае правіла для акна ў 24 гадзіны.
Выкіды
Дзень пазначаецца flag = "outlier", калі выконваюцца усе наступныя ўмовы:
- у яго ёсць
mid; - у яго мала кропак даных (вялікі рух у дзень з добрым пакрыццём ніколі не пазначаецца: ён лічыцца сапраўдным рухам рынку);
- яго
midадхіляецца больш чым на 10% ад медыяныmidнавакольнага акна ±15 каляндарных дзён (сам дзень не ўлічваецца); - у акне ёсць не менш за 3 іншыя дні з
mid(інакш даных недастаткова для ацэнкі, і дзень не пазначаецца).
Дні з выкідамі захоўваюць свае значэнні buy, sell, mid і spread_pct, каб кліенты маглі іх бачыць, але
яны выключаюцца з mid_7d і ўсіх разлікаў chg_* (як для самога дня з выкідам, так і для
дзён, якія спасылаліся б на яго).
Незалежныя публікатары і непацверджаныя рухі
- Адзін публікатар, адзін голас. Некалькі старонак або каналаў аднаго публікатара (адзін сайт, адзін акаўнт) лічацца адным голасам: іх катыроўкі спачатку звядзены да ўласнай медыяны публікатара, а медыяна гадзіны або дня вылічваецца паміж публікатарамі. Узровень, які паўтараецца на многіх старонках аднаго сайта, не можа перагаласаваць іншых публікатараў.
- Для
highпатрэбны тры незалежныя публікатары, чые даныя супадаюць у межах 2 %. Кропка, якую падтрымліваюць менш за тры публікатары, мае не вышэй заmedium, а кропка, публікатары якой утвараюць два розныя ўзроўні, ніколі не маеhigh: публікуецца ўзровень, што ўзгадняецца з апошнім шэрагам, а другі адкладаецца. - Рух, які не пацверджаны, не публікуецца. Калі гадзіна або дзень адхіляюцца больш чым на 15 % ад апошняга значэння шэрагу, яны публікуюцца, толькі калі іх падтрымліваюць не менш за трох незалежных публікатараў і яны ўзгадняюцца паміж сабой; інакш гадзіна не публікуецца, а шэраг захоўвае папярэдняе значэнне, пазначанае як перанесенае. Праўдападобны дыяпазон валюты рухаецца за рынкам па прыступках; большы зрух прымаецца, калі дастатковая колькасць незалежных публікатараў пацвярджае новы ўзровень на працягу некалькіх дзён запар.
- Крыніца, катыроўкі якой адпавядаюць узроўню іншай валюты (напрыклад, старонка суседняга рынку з катыроўкамі ўласнай валюты), адкладаецца для валюты, да якой яе аднеслі.
Праверка публікацыі
Кожная лічба правяраецца перад паказам (на сайце, у API і ў інструментах AI-асістэнтаў) па трох крытэрыях: іншыя кампаненты яе дня, яе ўласны пацверджаны шэраг і незалежны эталон (узровень, на якім валюта была пацверджана, і, калі ён публікуецца, афіцыйны курс).
- Кампаненты мусяць узгадняцца. Калі кампаненты дня адрозніваюцца больш чым на 10 %, дзень публікуецца з
ніжэйшым
confidence; калі яны адрозніваюцца больш чым на 50 %, лічбай становіцца кампанент, які ўзгадняецца з пацверджаным узроўнем валюты, а не іх сярэдняе, і ягоconfidenceроўныlimited. - Лічба, далёкая ад эталона, не публікуецца. Лічба, што больш чым удвая вышэйшая або менш чым удвая ніжэйшая за пацверджаны
ўзровень, або ніжэйшая за палову афіцыйнага курсу, не паказваецца, пакуль не будзе пацверджана; валюта ў гэты час пазначана як
coverage_in_progress. Лічба, якая адхіляецца больш чым на 30 % ад свайго ўзроўню або выходзіць за межы 0.7–3 разоў ад афіцыйнага курсу, публікуецца з ніжэйшымconfidence. - Новы ўзровень прымаецца, калі ён трымаецца. Сапраўдны рух (дэвальвацыя, новы рэжым) публікуецца з ніжэйшым
confidenceу першыя дні і прымаецца як новы ўзровень, калі трымаецца ў межах 5 % тры дні запар, штодня пацвярджаючыся двума кампанентамі або пяццю незалежнымі публікатарамі. - Змены паказваюцца, калі пацверджаны абодва дні. Дзённая, тыднёвая або месячная змена вышэй за 15 %, 30 % або 60 %
адпаведна паказваецца, толькі калі і бягучы дзень, і дзень, ад якога яна вымяраецца, прайшлі праверку; лічба
пад праверкай не мае змены (
nullу API, прочырк на сайце). highтрэба заслужыць. Лічба маеhigh, толькі калі тры незалежныя публікатары ўзгадняюцца ў межах 2 % ад яе або транзакцыйны кампанент сам маеhigh; лічба без якога-небудзь незалежнага эталона мае не вышэй заmedium.- Кожны апублікаваны дзень захоўвае запіс таго, з чым яго правяралі, таму лічбу можна прасачыць да таго, што яе пацвердзіла.
Перагляды і час
- Дні гэта каляндарныя дні UTC. Бягучы дзень няпоўны да 00:00 UTC і перагледжваецца на працягу дня;
ён пазначаецца
in_progress = true, пакуль яго кропак даных заметна менш за норму (гл. вышэй). - Паколькі акно выкідаў глядзіць на 15 дзён наперад, як і назад, пазнакі (а значыць,
mid_7dіchg_*) за апошнія 15 дзён могуць змяніцца пры паступленні новых даных. Уся гісторыя пералічваецца пры кожным абнаўленні. - Бясплатныя ключы API атрымліваюць даныя да папярэдняга дня; ключы pro і enterprise ўключаюць бягучы дзень.
- Шэрагі, якія выдаюцца кожнаму ключу API, могуць утрымліваць нязначныя індывідуальныя адрозненні.
Гадзінны індэкс (GET /v1/rates/{cur}/hourly, Pro і Enterprise)
Гадзінны індэкс гэта дзённы індэкс з гадзіннай дэталізацыяй: для кожнай гадзіны UTC і валюты buy і sell гэта
сярэднезважаныя курсы рынкавых транзакцый гадзіны на кожным баку, mid, side і spread_pct падпарадкоўваюцца
дзённым правілам, а confidence гэта базавы клас валюты.
- Як будуецца гадзінны шэраг. Для кожнай валюты з гадзіннымі рынкавымі данымі ёсць шэраг. Для кожнай гадзіны UTC
выкарыстоўваецца транзакцыйны кампанент, калі ў яго ёсць значэнне на гэту гадзіну; інакш шматкрыніцавы кампанент
(медыяна катыровак гадзіны, узважаная па надзейнасці, USDT улічваецца як USD), калі ў гэту гадзіну катыравалі не менш за 2 незалежныя
крыніцы; калі існуюць абодва, гадзіна мае тып
combined: транзакцыйнае значэнне, узважанае з шматкрыніцавай медыянай, доля якой расце разам з колькасцю яе крыніц (да адной другой ад 3 крыніц). Калі два значэнні адрозніваюцца больш чым на 3 %, гадзіна публікуецца з ніжэйшымqualityі правяраецца: кампаненты яе дня праходзяць Праверку публікацыі, апісаную вышэй, а гадзіна лічбы, якая не публікуецца, або якая больш чым удвая адрозніваецца ад пацверджанага ўзроўню, таксама не публікуецца. Кожная гадзіна паказвае свойcomponent(transaction_based,multi_source,combined). Нічога не інтэрпалюецца; гадзіна без катыровак паўтарае апошнюю гадзіну з катыроўкамі з пазнакай (гл. Гадзіны без катыровак). Калі ў валюты менш за 6 гадзін са значэннем за дзень UTC (для бягучага дня: за апошнія 24 гадзіны), гэтыя гадзіны маюцьquality: limited, і сайт малюе іх кропкамі, а не лініяй. - Гадзіны без катыровак. Рынкавыя крыніцы катыруюць у дзённы час сваёй краіны; уначы ў валюты можа не быць
катыровак гадзінамі. Такая гадзіна паўтарае значэнне апошняй гадзіны з катыроўкамі, як і ў іншых індэксах, і паведамляе пра гэта:
carried: true,carried_from(гадзіна, з якой узята значэнне) іage_hours(узрост значэння; 0 для гадзіны з катыроўкамі). Значэнне пераносіцца не больш чым на 72 гадзіны; пасля гэтага гадзіна адсутнічае, пакуль не вернуцца катыроўкі. Перанесеныя гадзіны ніколі не трапляюць у дзённы індэкс, дзённае зводнае (hours,vwap,high,low) або правіла 6 гадзін вышэй; сайт паказвае ўзрост апошняй катыроўкі ("абноўлена 9 г таму (апошняя катыроўка 23:00 UTC)") і шэрую кропку, калі яна старэйшая за 3 гадзіны. - Гадзіны і бакі. Радок з катыроўкамі існуе для кожнай гадзіны з рынкавымі данымі. Каб бок быў апублікаваны, патрэбна не менш за 3 кропкі даных
у гадзіну; калі іх менш, ён роўны
null, а калі існуе толькі адзін бок,midроўны гэтаму боку (sideпаказвае, якому). Для валют з меншай колькасцю кропак даных гадзіны са значэннем індэкса адпаведна радзейшыя: гадзіны паміж імі пераносяцца (з пазнакай), а не запаўняюцца шумам, і гэта зроблена наўмысна. - Выкіды ўнутры гадзіны. Агрэгаты гадзіны будуюцца па транзакцыях у межах ±20 % ад уласнага медыяннага
курсу гадзіны; пасля гэтага нічога больш не фільтруецца, і гадзінныя радкі не маюць
flag. Правіла пра бок, які не рухаецца (вышэй), прымяняецца для акна ў 24 гадзіны. - Дзённая зводка. Кожны дзень у адказе па валюце змяшчае
vwap(узважаны сярэдні курс за ўвесь дзень, абодва бакі разам),highіlow(найвышэйшы і найніжэйшы гадзінныmid),hours(гадзіны са значэннем індэкса) іpeak_hour(гадзіна з найбольшай рынкавай актыўнасцю).highіlowбяруцца з гадзін з дастатковай колькасцю кропак дадзеных (не менш за 5 за гадзіну) і, калі такія гадзіны ў дні ёсць, толькі з двухбаковых гадзін:mid, заснаваны на адным баку рынку, знаходзіцца прыкладна за паўспрэда ад двухбаковага, і іх змешванне паказала б дыяпазон, якога рынак ніколі не меў.hoursпа-ранейшаму лічыць кожную гадзіну са значэннем індэкса. - У працэсе. Бягучая гадзіна UTC мае
in_progress = true, пакуль яна збіраецца, і будзе пераглядацца;GET /v1/rates/hourly/latestвяртае толькі поўныя гадзіны. - Унутрыгадзінныя катыроўкі. Крыніцы, якія публікуюць курс з бесперапынным абнаўленнем, счытваюцца кожныя 10 хвілін. Гадзіна застаецца адзінкай індэкса, і ўнутры гадзіны кожная такая крыніца ўлічваецца адзін раз, незалежна ад колькасці яе счытванняў (медыяна яе счытванняў, затым узважаная медыяна па крыніцах).
GET /v1/street-index/{cur}/latestдадаеnow(ts,mid,n_sources), пакуль апошняе 10-хвіліннае значэнне не старэйшае за 20 хвілін, іnullу адваротным выпадку; сайт паказвае яго як «абноўлена N хв таму», а валюта без такога значэння паказвае апошнюю поўную гадзіну. 10-хвілінныя значэнні не з'яўляюцца гістарычным прадуктам: API не вяртае шэрагаў па хвілінах. - Тэрміны. Гадзінныя радкі на аснове транзакцый паступаюць са штодзённым абнаўленнем, якое ахоплівае апошнія тры дні (тады падхопліваюцца познія транзакцыі і перасчэты): абнаўленне штодня, гадзінная дэталізацыя, не струмень у рэальным часе. Шматкрынічныя гадзіны перасчытваюцца на працягу дня за апошнія 72 гадзіны. Гадзінныя радкі, старэйшыя за гарызонт гісторыі, спісваюцца з квоты гісторыі па 1/24 дзённага радка. Публічны сайт паказвае апошнія 24 поўныя гадзіны кожнай валюты з гадзінным шэрагам і курс апошняй поўнай гадзіны; паміж вядомымі гадзінамі графік малюе прамую лінію і працягвае апошняе значэнне да правага краю (толькі для адлюстравання).
Шматкрынічны вулічны індэкс (GET /v1/street-index, прадукт «Street Rate Index - multi-source»)
Для кожнай валюты, па якой публічныя рынкавыя крыніцы публікуюць вулічныя курсы (побач з серыяй на аснове транзакцый, дзе яна ёсць, і асобна, дзе яе няма), індэкс публікуе курс, абвешчаны ў адкрытых крыніцах: публічныя Telegram-каналы абменных пунктаў, раздзелы з курсамі ў мясцовых выданнях, форумы. Апублікаваны курс - гэта факт; мы захоўваем лічбу, час і спасылку на допіс, але ніколі не тэкст.
- Катыроўка - адна лічба з аднаго публічнага допісу: каціруемая валюта (ISO 4217), база (
USD;USDTлічыцца як USD з пазнакай; катыроўкіEURзахоўваюцца асобна і не канвертуюцца), бок, курс за 1 адзінку базы, час допісу (UTC), спасылка. Фрагмент не даўжэйшы за 200 сімвалаў вакол лічбы захоўваецца толькі для аўдыту і ніколі не паказваецца. З аднаго допісу можа атрымацца некалькі катыровак (куплю і продаж, некалькі валют, некалькі гарадоў). - Дамоўленасць аб баку.
side- гэта дзеянне кліента, як і ў індэксе: кліент купляе USD па кошце продажу абменніка (большая лічба) і прадае USD па кошце куплі абменніка. Допіс, у якім пара пазначана наадварот, разварочваецца і пазначаецца паніжаным узроўнем даверу.mid- гэта катыроўка без бакоў. - Здабыванне. Спачатку рэгулярныя выразы для распаўсюджаных фарматаў («USD 1650/1665», «Покупка: 11810 / Продажа: 11860», «$ = ₦1,650», «1 USDT = 41.25 TRY», «Dolar: 49,72», формы запісу на дары, арабскай, урду, бенгальскай і персідскай мовах; тысячы, запісаныя з прабеламі, апострафамі або кропкамі; томан = 10 рыялаў). Радкі пра афіцыйныя, цэнтральнабанкаўскія, біржавыя і прагнозныя курсы прапускаюцца. Допісы са словам пра валюту і лічбай, але без супадзення, перадаюцца моўнай мадэлі пакетамі як дадзеныя; кожная вернутая ёю лічба правяраецца гэтак жа, як супадзенне рэгулярнага выразу.
- Праўдападобны дыяпазон для кожнай валюты і базы: эталон на аснове транзакцый за апошнія 30 дзён, інакш медыяна катыровак за апошнія 14 дзён (≥ 5), інакш стартавае значэнне; дыяпазон - гэта эталон ± 60 %. Катыроўкі па-за ім захоўваюцца з пазнакай
outlierі ніколі не трапляюць у індэкс; катыроўкі, захаваныя да з'яўлення дыяпазону, правяраюцца паўторна, калі ён з'явіцца. - Давер да крыніцы (
reliability, 0–1, перасчытваецца штодня за апошнія 30 дзён): - дакладнасць =
max(0, 1 − dev / 5 %),dev= медыяна |катыроўка / эталон − 1|; эталон - гэта эталон на аснове транзакцый таго ж дня UTC, калі ён ёсць (каліброўная крыніца), інакш медыяна без уліку самой крыніцы не менш чым двух іншых крыніц па гэтай валюце і дні; пры поўнай адсутнасці эталона - 0.5. Для каліброўнай крыніцы спачатку выключаецца зрух, агульны для ўсёй групы крыніц гэтай валюты адносна эталона (медыянны адхіл астатніх крыніц у той дзень, не менш чым двух з іх): рынак наяўных, які катыруецца на некалькі працэнтаў ад рынку лічбавага долара, - уласцівасць гэтага рынку, а не памылка крыніцы, што пра яго паведамляе. Таму дакладнасць вымярае, наколькі крыніца аддалена ад кансенсусу рынку; раскід і выкіды штрафуюцца, як і раней; - сам агульны зрух публікуецца разам з днём як
basis_gap_pct= (шматкрынічныmid/ эталон на аснове транзакцый − 1) × 100: прэмія (адмоўная: дыскант) каціруемага вулічнага курсу да кампаненты на аснове транзакцый у гэты дзень, па сутнасці розніца паміж рынкам наяўных і рынкам лічбавага долара. Гэта кампанента індэкса, а не папраўка: ніводная серыя ёю не карэгуецца; - чысціня = 1 − доля выкідаў; стабільнасць =
max(0, 1 − dispersion / 3 %), dispersion = медыяна ўнутрыдзённага (max − min) / медыяна катыровак крыніцы; рэгулярнасць = дні з катыроўкамі / 20, не больш за 1; reliability = 0.5·accuracy + 0.2·cleanliness + 0.15·stability + 0.15·regularity, у межах [0.05, 1]. Крыніца з менш чым 5 катыроўкамі захоўвае пачатковае значэнне 0.3. Тры дзённыя ацэнкі запар ніжэй за 0.2 прыпыняюць крыніцу на 7 дзён; потым яна вяртаецца як кандыдат і павінна зноў заслужыцьactive(≥ 5 валідных катыровак за 3 дні). Гісторыя захоўваецца па днях.- Дзень (
GET /v1/street-index/{cur}/history):mid= узважаная па даверы да крыніц медыянаmidдопісаў (купля і продаж аднаго допісу ўсрэдняюцца; адзінокая катыроўка ўлічваецца як ёсць),buy/sell= узважаныя медыяны адпаведных катыровак,spread_pct = (buy − sell) / mid × 100. Дзень публікуецца толькі пры ≥ 3 катыроўках ад ≥ 2 крыніц; інакш радка няма.n_sources,n_quotes,confidence(0–1: палова ад колькасці крыніц, 1 пры чатырох і больш; палова ад згоды, 1 калі медыянны адхілmidроўны 0 і 0 пры 5 %) іconfidence_class(high: ≥ 3 крыніцы, што згаджаюцца ў межах 2 %;medium: ≥ 3 крыніцы;limited: менш крыніц) апісваюць дзень. Гадзінны шэраг існуе толькі для гадзін з ≥ 3 катыроўкамі. - Вулічны курс горада (
GET /v1/street-index/{cur}/cities, старонкі гарадоў для пунктаў абмену) публікуецца па не менш чым двух незалежных выдаўцах у гэтым горадзе (некалькі старонак або каналаў аднаго выдаўца лічацца адзін раз;n_sources- колькасць выдаўцоў), адзін горад пад адной назвай незалежна ад напісання ў допісах. Перад выхадам ён правяраецца па апублікаваным індэксе краіны за той жа дзень і па афіцыйным курсе, як і лічба краіны. Лічба горада, якая моцна адрозніваецца ад індэкса сваёй краіны, не публікуецца, пакуль не ўтрымаецца тры дні запар, штодня пацвярджаная пяццю незалежнымі выдаўцамі (рынак з двума рэжымамі, дзе курс горада сапраўды адрозніваецца ад астатняй краіны); лічба горада, умерана адхіленая ад краіны, публікуецца з узроўнем даверу (confidence) не вышэй заmedium. Пакуль лічба краіны ўтрымліваецца, курс ніводнага горада гэтай валюты не публікуецца. - Доступ. Бясплатныя ключы: валюты бясплатнага ўзроўню з затрымкай 1 дзень; Pro: усе валюты; Enterprise: таксама
катыроўкі за кожны дзень са спасылкамі на крыніцы (
GET /v1/street-index/{cur}/quotes). Дні перасчытваюцца штодня за апошнія 45 дзён і могуць змяняцца пры паўторнай ацэнцы або паўторнай пазнацы крыніц. - Абмежаванні. Допісы - гэта тое, што крыніцы выбралі апублікаваць; крыніца можа спазняцца, памыляцца або быць рэкламнай, і менавіта для гэтага патрэбная ацэнка даверу. Ахоп па валюце паказаны ў
n_sources. Не з'яўляецца інвестыцыйнай парадай.
Старонкі валют і статыстыка сайта
- Кожная валюта мае публічную старонку (
/rates/{CUR}): курс апошняй гадзіны, змены, апошнія 24 гадзіны, графікі за 90 дзён і за 1 год, параўнанне афіцыйнага і вулічнага курсаў, дзе прадукт ахоплівае валюту, апошнія 30 дзён і тыя ж лічбы, што аддае API. Старонкі,/sitemap.xml,/llms.txtі/llms-full.txtгенеруюцца з індэкса; пры цытаванні лічбы называйце крыніцу як «EMpulse Street FX Index». - Сайт вядзе ўласную статыстыку наведванняў без cookie і знешніх трэкераў: прагляды старонак, краіны і крыніцы пераходаў агрэгуюцца з access log сервера раз на гадзіну; IP-адрасы не захоўваюцца (наведвальнікі лічацца праз хэш са штодзённа змяняемай soль). Краіна наведвання вызначаецца па IP-адрасе з дапамогай базы DB-IP Lite - IP Geolocation by DB-IP (https://db-ip.com), ліцэнзія CC BY 4.0.
Гарадскія табло і карткі абменнікаў
- Старонка горада (
/rates/{CUR}/{city}) паказвае індэкс па краіне і ніжэй табло абменных пунктаў горада, якія адкрыта публікуюць свае курсы (іх публічныя старонкі і каналы): медыяну гэтых табло, колькасць абменнікаў за ёй і клас упэўненасці:limitedпры менш чым трох табло,mediumад трох,high, калі табло супадаюць у межах 2 %. Табло старэйшае за тры дні не паказваецца. Медыяна табло праходзіць ту самую праверку супраць індэкса краіны і афіцыйнага курсу, што і вулічны курс горада: медыяна, якая яе не праходзіць, не паказваецца (карткі абменнікаў застаюцца). - Кожны абменнік з публічным табло атрымлівае картку, пабудаваную на гэтым табло: публічная назва бізнэсу, яго горад, сайт або канал і курсы, якія ён публікуе. Асоба не фіксуецца: ніякіх імёнаў, нумароў тэлефонаў і дакументаў; адзіны захоўваемы кантакт - адкрыты адрас бізнэсу на яго ўласным сайце.
- Бізнэс пацвярджае права на картку без якіх-небудзь дзеянняў з боку чалавека: праз код, размешчаны ў файле або meta-тэгу на яго сайце, у допісе яго канала, у паведамленні боту EMpulse ад акаўнта, які адмініструе канал, або праз спасылку ў лісце на адкрыты адрас. Пацверджаная картка мае значок, стаіць першай на гарадскім табло і можа публікаваць уласныя курсы (праз каманду боту, свой канал або ўласны ключ).
- Уласныя курсы паказваюцца асобна ад індэкса з пазнакай, што гэта ўласныя курсы абменніка. Яны трапляюць у індэкс толькі як яшчэ адна крыніца з надзейнасцю, якую заслужылі (тыя ж правілы даверу, што і для кожнай іншай крыніцы); курс, які разыходзіцца з гарадскім табло больш чым на дапушчальную адлегласць, не прымаецца і зніжае рэйтынг карткі, але ніколі яго не павышае. Паўторныя адхіленні прыпыняюць публікацыю курсаў. Праз гэту крыніцу ўласныя курсы пацверджаных абменнікаў таксама ўлічваюцца ў актыўнасці валюты, як і любая іншая крыніца шматкрыніцавага складніка.
Калідоры (GET /v1/corridors/{a}/{b}, /corridors/{A}-{B}, Pro і Enterprise)
Многія валюты развівающихся рынкаў абменьваюцца адна на адну наўпрост: сом на тэнге, грыўна на дырхамы, рупіі на рыялы. Гэта адбываецца ў публічных форумах, каналах і на дошках аб'яў, без даляравага складніка. Індэкс чытае гэтыя публічныя аб'явы на мовах краін і публікуе курс калідора пары побач з крос-курсам, які вынікае з яе ўласных даляравых складнікаў.
- Аб'ява - гэта адно публічнае паведамленне, у якім названы дзве недаляравыя валюты і цана або дзве сумы ("куплю сумы за тенге, 100 000 сум за 4 000 тенге", "1 KZT = 25.3 UZS", "vendo pesos por reales"). Мы захоўваем пару, курс (адзінак другой валюты за 1 адзінку першай), бок аўтара, сумы, калі яны названы, горад і клас спосабу аплаты (гатоўка / пераказ / картка), час і спасылку. Нумары тэлефонаў, імёны карыстальнікаў, адрасы электроннай пошты і спасылкі ўнутры тэксту выдаляюцца да таго, як нешта захоўваецца; аўтары ніколі не фіксуюцца. Спачатку ужываюцца правілы для распаўсюджаных формаў; паведамленне з дзвюма валютамі, якія правілы не распазналі, перадаецца моўнай мадэлі як даныя, і кожны лік, які яна вяртае, правяраецца гэтак жа, як супадзенне з правілам.
- Праўдападобнасць. Аб'ява правяраецца па курсе, які вынікае з двух даляравых складнікаў індэкса
(
b per USD ÷ a per USD) ± 60 %: перавернуты лік пераварочваецца з пазнакай, лік па-за межамі дыяпазону лічыцца выкідам і ніколі не трапляе ў курс. Прапановы ў далярах у тым жа паведамленні пакідаюцца даляравому індэксу. - Дзень (
rate) - гэта медыяна карэктных аб'яў пары за дзень, узважаная па даверы, зlowіhighза дзень;sourcesлічыць незалежныя публічныя крыніцы за ёй;confidenceроўныhigh, калі тры і больш крыніц супадаюць у межах 3 %,mediumпры дзвюх,limitedпры адной або калі ў аднаго з даляравых складнікаў пары яшчэ няма эталоннага значэння. Пара публікуецца з першай аб'явы; адна аб'ява даеlimited. implied_cross- гэта той самы курс, разлічаны па двух даляравых курсах індэкса за той самы дзень (кожны не старэйшы за тры дні);corridor_premium_pct= (rate / implied_cross − 1) × 100 - кошт прамога шляху замест шляху праз долар: дадатнае значэнне азначае, што калідор даражэйшы, адмоўнае - танейшы. Два напрамкі пары ўтвараюць адзін рад:b per aіa per bузаемна адваротныя, як і прэміі.- Валюты без даляравага рынку. Калі ў валюты няма ўласнага даляравага складніка, але яна коціруецца да
валюты, у якой ён ёсць, індэкс выводзіць яе даляравы курс праз калідор (
a per USD = b per USD ÷ b per a, узважаная медыяна па такіх калідорах за дзень). Гэты вытворны рад уваходзіць у правіла актыўнасці, як і любы іншы складнік, з класам упэўненасці на адзін ніжэй, чым у калідора, з якога ён атрыманы, і ніколі не выкарыстоўваецца як даляравы складнік іншага калідора. - Доступ. Публічныя старонкі паказваюць апошні дзень; ключы Pro і Enterprise таксама даюць бягучы дзень у API,
гісторыю і спіс найдаражэйшых і найтанейшых калідораў (
/v1/corridors/top). Аб'явы чытаюцца толькі з публічных крыніц, чые robots.txt і ўмовы гэта дазваляюць; крыніцы, якія забараняюць аўтаматычнае чытанне або паўторнае выкарыстанне, не ўлічваюцца.
Абмежаванні
- Вулічныя курсы адлюстроўваюць тое, што людзі фактычна плацяць на вулічным рынку; гэта не афіцыйныя, не курсы цэнтральнага банка і не міжбанкаўскія курсы, і яны могуць істотна ад іх адрознівацца.
- Рады з
confidence = limitedмаюць прапускі (дні без значэння або безmid) і большы шум. Правярайцеconfidenceіflag, перш чым выкарыстоўваць значэнне. - Пакрыццё пачынаецца з розных дат для розных валют (
coverage_sinceуGET /v1/currencies), і валюта можа некаторы час мець статусcoverage_in_progress(гл. "Пакрыццё і актыўнасць"). - Індэкс прадастаўляецца толькі ў інфармацыйных мэтах і не з'яўляецца інвестыцыйнай парадай.