EMpulse Street FX Index: Mbinu

EMpulse Street FX Index huchapisha kila siku viwango vya ubadilishaji vya "mtaani" vya sarafu za masoko yanayoibukia dhidi ya USDT (inayochukuliwa kuwa sawa na 1 USD): kiwango ambacho watu hulipa kwa kweli, si cha kiofisi. Kielezo huunganisha data ya soko inayotokana na miamala na nukuu kutoka vyanzo vya umma vya soko; kila mfululizo una daraja la uhakika, na mipaka ya data huchapishwa pamoja nayo.

Vipengele

Viwango vyote hunukuliwa kama fiat kwa kila 1 USDT.

Kipengele kinachotokana na masoko ya kubadilishana

• Masoko yapi. Ni masoko ya kubadilishana tu yanayochapisha API ya umma iliyoandikwa kwa ofa zake, inayosomeka bila akaunti, ambayo masharti yake hayakatazi usomaji wa kiotomatiki wala usambazaji upya, na ambayo robots.txt yake inaruhusu endpoint hiyo. Mengine yote yameachwa, na masharti ya kila soko husomwa upya kila siku 30: soko ambalo masharti yake yanabadilika huondoka lenyewe. Masoko yaliyo nyuma ya takwimu huonekana kama idadi tu (sources); orodha ya masoko huchapishwa hapa kwa idhini yao na vinginevyo haiambatishwi kwenye takwimu yoyote.
• Saa. Kwa kila soko la kubadilishana, sarafu na upande, ofa bora kwa bei (hadi 20) hutoa bei bora, medianu, bei yenye uzito wa kina na kina (kiasi kinachotolewa, kwa USDT). Pande hufuata mkataba wa kielezo: buy ni upande ambao mteja hununua dola ya kidijitali. Soko la kubadilishana linalonukuu bitcoin badala ya tokeni ya dola huingia kupitia kitabu chake cha dola ya Marekani cha saa hiyo hiyo (bei kwa sarafu ÷ bei kwa dola), hivyo kila takwimu ni kiwango cha dola. Kati ya masoko, mid, buy na sell za saa ni medianu zenye uzito wa kuaminika; exchange_spread_pct = (juu zaidi − chini zaidi ya mid ya soko) / medianu × 100 kukiwa na angalau masoko mawili. Siku huchukua medianu za saa zake.
• Kuaminika kwa soko la kubadilishana (0–1, hukokotolewa upya kila siku kwa siku 30): usahihi = max(0, 1 − dev / 5 %), dev = umbali wa kati wa mid ya soko kutoka medianu ya masoko mengine katika saa hiyo hiyo (kukiwa na masoko mengine pungufu ya mawili, kutoka kwenye rejeo la siku linalotokana na miamala); kigezo cha kina (kina dhidi ya kiwango cha kawaida) na kigezo cha uchangamfu (saa zenye data katika siku iliyopita); 0.5·accuracy + 0.25·depth + 0.25·freshness. Soko la kubadilishana ambalo bei zake ziko mbali na za mengine, yaani kitabu kilichopitwa na wakati au kilichochezewa, hupoteza uzito mara moja; alama tatu za kila siku chini ya 0.2 huliweka kando kwa wiki moja.
• Uhakika. Siku ni high ikiwa kuna angalau masoko matatu ya kubadilishana yaliyo ndani ya 2 % kati yao, medium ikiwa kuna angalau masoko matatu, limited ikiwa ni pungufu. Siku huingia kwenye kielezo kimoja cha umma cha sarafu kwa kanuni iliyo hapa chini; sarafu inayonukuliwa na masoko ya kubadilishana ambayo hakuna kipengele kingine kinachoifunika huwa hai kupitia kipengele hiki pekee.

Ufunikaji na shughuli

Kielezo cha sarafu ni namba moja kwa siku, iliyojengwa kutoka vipengele vilivyotajwa hapo juu:

• ikiwa kipengele kimoja tu kinachapisha, kielezo ni kipengele hicho;
• ikiwa vingi vinachapisha, siku ya karibuni zaidi hushinda; vipengele vinavyochapisha siku hiyo hiyo hupigwa wastani kwa uzito kulingana na uhakika: kipengele kinachotokana na miamala kwa uzito 1 / 0.6 / 0.3 kwa siku ya high / medium / limited, vipengele vya vyanzo vingi na vya masoko ya kubadilishana kwa alama yao ya uhakika (0–1, angalau 0.1).

Sarafu ni hai pale kielezo kina siku ndani ya siku 14 zilizopita (/v1/currencies: status = "active", active_since = siku ya kwanza ya mfululizo wa sasa wa data usio na pengo refu kuliko siku 14). Sarafu isiyo na siku ya karibuni iko katika ufunikaji unaoendelea: tunaiongezea vyanzo vya soko, historia yake iliyochapishwa inabaki kupatikana, na inarudi kwenye orodha ya sarafu hai yenyewe pindi siku ya karibuni itakapopatikana. Jedwali la moja kwa moja la tovuti linaonyesha sarafu hai pekee; idadi ya sarafu zinazonukuliwa kwenye mipango ni idadi ya sarafu hai.

Kwa kila sarafu hai, siku ya hivi karibuni ina:

• sources: idadi ya vyanzo huru vya soko vilivyo nyuma ya siku (kipengele kinachotokana na miamala huhesabiwa kama kimoja, kila soko la kubadilishana la kipengele cha masoko ya kubadilishana kama kimoja). Huchapishwa pale ni mbili au zaidi, na daima kwa siku ya limited ("chanzo 1, uhakika mdogo"); vinginevyo huwa tupu (null kwenye API).
• confidence: daraja la siku ya hivi karibuni (high / medium / limited, tazama hapa chini); siku ikiwa na umri wa siku tatu au zaidi huonyeshwa daraja moja chini.

Sarafu huchapishwa kuanzia chanzo chake cha kwanza cha soko: siku yenye chanzo kimoja ni limited na ina ujumbe coverage improving (tovuti, API, MCP): namba ni halisi, kutokuwa na uhakika kwake kunatajwa, na vyanzo zaidi vinaongezwa. medium inahitaji vyanzo viwili huru, high vitatu vinavyokubaliana ndani ya 2 %. Kipengele cha masoko ya kubadilishana huingia kwenye kanuni ya shughuli pale tu vitabu vyake vya oda vinapoonyesha angalau ofa tatu huru kwa saa na siku mbili za data; sarafu isiyo na hata pointi moja ya data hubaki coverage_in_progress.

Sehemu za kielezo cha kila siku (GET /v1/rates/{cur})

• buy: kiwango cha wastani chenye uzito cha siku ambacho mteja hununua USDT kwa fiat. Upande wenye pointi chache mno za data kwa siku ni null.
• sell: sawa na hapo juu kwa upande ambao mteja anauza USDT.
• mid: (buy + sell) / 2 pale buy na sell zote zipo. Ikiwa upande mmoja tu wa soko upo, mid ni sawa na kiwango cha upande huo (tazama side). Ikiwa hakuna upande wowote, mid ni null.
• side: kile ambacho mid inategemea: both, buy (buy pekee ipo) au sell (sell pekee ipo); null pale hakuna mid. mid inayotegemea upande mmoja wa soko hubadilika kwa takriban nusu ya spread ikilinganishwa na ile ya pande mbili, kwa hiyo zingatia side unapolinganisha siku.
• spread_pct: (buy − sell) / mid × 100, tu pale side = "both"; vinginevyo null. Kwa kawaida ni chanya; spread hasi inaweza kutokea katika siku zenye data pungufu na huchapishwa kama ilivyo.
• confidence: high, medium au limited. Kila sarafu ina daraja la msingi kutokana na ufunikaji wake (GET /v1/currencies: high kwa mfululizo uliofunikwa vizuri zaidi, medium kwa mingine); siku yenye pointi chache za data kuliko kawaida iko daraja moja chini (high → medium, medium → limited). limited inamaanisha pointi chache za data: kelele zaidi, mapengo yanayowezekana.
• in_progress: true kwa siku ya hivi karibuni ya sarafu wakati siku bado inakusanywa na pointi zake za data ziko wazi chini ya kawaida ya siku 7 za kalenda zilizotangulia (siku zenye data pekee). Siku kama hiyo itarekebishwa. Siku nyingine zote ni false.
• mid_7d: wastani wa hesabu wa thamani halali za mid katika siku 7 za kalenda zilizopita, pamoja na siku yenyewe. Siku zisizo na mid halali huruka; null ikiwa hakuna.

• chg_1d_pct, chg_7d_pct, chg_30d_pct: (mid / mid_N_days_ago − 1) × 100, ikilinganisha na siku 1, 7 au 30 kamili za kalenda zilizotangulia. null ikiwa siku yoyote kati ya hizo mbili haina mid halali (hakuna kubeba mbele juu ya mapengo) au ikiwa siku hizo mbili zina side tofauti (kwa mfano both dhidi ya buy): mid ya upande mmoja hubadilika kwa takriban nusu ya spread, hivyo ulinganisho kama huo ungeonyesha mwendo ambao haukutokea.

• exchange_spread_pct (Pro na Enterprise): tofauti ya bei kati ya masoko ya kubadilishana ya kipengele cha masoko ya kubadilishana katika siku hiyo (tazama hapo juu); null kukiwa na masoko pungufu ya mawili.

"mid halali" inamaanisha mid isiyo null ambayo haijawekewa alama kama thamani ya nje (outlier).

Upande usiosogea

Wakati mwingine upande mmoja wa soko huacha kusonga huku mwingine ukiendelea kufanya biashara kwa bei zinazobadilika: kwa siku kadhaa (tano, kwa faharasa ya kila siku) kiwango chake cha kati (median) hubaki ndani ya 0.05 %, au kila siku upande huo hufungwa kwa bei moja. Bei kama hiyo hutajwa kwenye nukuu badala ya kuwa ya muamala, na mid iliyo katikati ya bei hiyo na upande unaosonga haingekuwa na maana. Katika hali hiyo faharasa hutegemea upande unaosonga pekee: mid ni sawa na kiwango cha upande huo, side huutaja (buy au sell) ingawa buy na sell zote huchapishwa, na spread_pct ni null. Kanuni hutumika siku kwa siku na hukoma yenyewe mara upande uliotulia unapoanza kusonga tena; pande zote mbili zinapotulia kwa kiwango sawa (soko tulivu kabisa) hakuna kinachobadilika. Faharasa ya kila saa hutumia kanuni hiyo hiyo kwenye dirisha la saa 24.

Thamani zilizopotoka (outliers)

Siku huwekewa alama flag = "outlier" wakati yote yafuatayo yanatimia:

1. ina mid;
2. ina pointi chache za data (mabadiliko makubwa katika siku yenye data ya kutosha hayawekewi alama kamwe: huchukuliwa kama mabadiliko halisi ya soko);
3. mid yake inatofautiana kwa zaidi ya 10% na mid ya kati ya dirisha linalozunguka la siku ±15 za kalenda (siku yenyewe haihesabiwi);
4. dirisha lina angalau siku 3 nyingine zenye mid (vinginevyo data haitoshi kuhukumu, na siku hiyo haiwekewi alama).

Siku za outlier huhifadhi thamani zao za buy, sell, mid na spread_pct ili wateja waweze kuziona, lakini hazijumuishwi katika mid_7d na hesabu zote za chg_* (kwa siku ya outlier yenyewe na kwa siku zitakazoirejelea).

Masahihisho na muda

• Siku ni siku za kalenda za UTC. Siku ya sasa haijakamilika hadi 00:00 UTC na husahihishwa wakati wa siku; huwekewa alama in_progress = true wakati pointi zake za data ziko chini wazi kuliko kawaida (tazama hapo juu).
• Kwa kuwa dirisha la outlier linaangalia siku 15 mbele pamoja na nyuma, alama (na hivyo mid_7d na chg_*) za siku 15 za hivi karibuni zaidi zinaweza kubadilika data mpya inapowasili. Historia yote hukokotolewa upya kwa kila usasishaji.
• Funguo za API za bure hupokea data hadi siku iliyotangulia; funguo za pro na enterprise hujumuisha siku ya sasa.
• Mfululizo unaotolewa kwa kila ufunguo wa API unaweza kuwa na tofauti ndogo za kibinafsi zisizo na umuhimu.

Faharasa ya kila saa (GET /v1/rates/{cur}/hourly, Pro na Enterprise)

Faharasa ya kila saa ni faharasa ya kila siku kwa kiwango cha saa: kwa kila saa ya UTC na kila sarafu, buy na sell ni viwango vya wastani vilivyopimwa vya miamala ya soko ya saa hiyo kwa kila upande, mid, side na spread_pct hufuata kanuni za kila siku, na confidence ni daraja la msingi la sarafu.

• Jinsi mfululizo wa kila saa unavyojengwa. Kila sarafu yenye data ya soko ya kila saa ina mfululizo. Kwa kila saa ya UTC kijenzi kinachotegemea miamala hutumika kinapokuwa na thamani kwa saa hiyo; vinginevyo kijenzi cha vyanzo vingi (wastani wa kati uliopimwa kwa uaminifu wa nukuu za saa hiyo, USDT ikihesabiwa kama USD) wakati angalau vyanzo 2 huru vilitoa nukuu katika saa hiyo; zote mbili zikiwepo saa huwa combined: thamani inayotegemea miamala hupimwa pamoja na wastani wa kati wa vyanzo vingi, ambao sehemu yake hukua kadiri idadi ya vyanzo inavyoongezeka (hadi nusu kuanzia vyanzo 3). Zinapotofautiana kwa zaidi ya 3 %, saa huchapishwa ikiwa na quality ya chini na hukaguliwa. Kila saa hutaja component yake (transaction_based, multi_source, combined). Saa isiyo na data haipo: hakuna kinachokadiriwa katikati wala kuhamishwa mbele. Sarafu ikiwa na chini ya saa 6 zenye thamani katika siku moja ya UTC (kwa siku ya sasa: katika saa 24 za mwisho), saa hizo hubeba quality: limited na tovuti huzichora kama nukta, si kama mstari.
• Saa na pande. Safu ipo kwa kila saa yenye data ya soko. Upande unahitaji angalau pointi 3 za data katika saa hiyo ili uchapishwe; ukiwa na chache zaidi huwa null, na upande mmoja tu ukiwepo mid ni upande huo (side husema upi). Kwa sarafu zenye pointi chache za data, saa zenye thamani ya faharasa ni nadra zaidi ipasavyo: mfululizo wa kila saa una mapengo badala ya kelele, kwa makusudi.
• Outliers ndani ya saa. Jumla za saa hujengwa kutoka miamala iliyo ndani ya ±20 % ya kiwango cha kati cha saa yenyewe; hakuna kingine kinachochujwa baadaye, na safu za kila saa hazina flag. Kanuni kuhusu upande usiosonga (hapo juu) hutumika kwenye dirisha la saa 24.
• Muhtasari wa kila siku. Kila siku katika jibu la kila sarafu ina vwap (kiwango cha wastani kilichopimwa cha siku nzima, pande zote mbili pamoja), high na low (mid ya juu zaidi na ya chini zaidi ya saa), hours (saa zenye thamani ya faharasa) na peak_hour (saa yenye shughuli nyingi zaidi za soko). high na low huchukuliwa kutoka saa zenye pointi za data za kutosha (angalau 5 katika saa) na, siku ikiwa nazo, kutoka saa za pande mbili pekee: mid inayotokana na upande mmoja wa soko iko umbali wa takriban nusu ya spread kutoka ile ya pande mbili, na kuchanganya hizo mbili kungeonyesha masafa ambayo soko halikuwahi kufikia. hours bado huhesabu kila saa yenye thamani ya faharasa.
• Inaendelea. Saa ya sasa ya UTC ni in_progress = true wakati inakusanywa na itasahihishwa; GET /v1/rates/hourly/latest hurejesha saa kamili tu.
• Muda. Safu za kila saa zinazotegemea miamala hufika pamoja na usasishaji wa kila siku, unaohusu siku tatu za mwisho (miamala iliyochelewa na hesabu upya huchukuliwa wakati huo): husasishwa kila siku, kwa kiwango cha saa; si mtiririko wa wakati halisi. Saa za vyanzo vingi hukokotolewa upya mchana kutwa kwa saa 72 za mwisho. Safu za kila saa za zamani kuliko upeo wa historia huhesabiwa dhidi ya kiwango cha historia kwa 1/24 ya safu ya kila siku. Tovuti ya umma inaonyesha saa 24 kamili za mwisho za kila sarafu yenye mfululizo wa kila saa, na kiwango cha saa kamili ya mwisho; kati ya saa zinazojulikana chati huchora mstari ulionyooka na kushikilia thamani ya mwisho hadi ukingo wa kulia (kwa maonyesho tu).

Faharasa ya street ya vyanzo vingi (GET /v1/street-index, bidhaa "Street Rate Index - multi-source")

Kwa kila sarafu ambayo vyanzo vya umma vya soko huchapisha viwango vya street (pamoja na mfululizo unaotegemea miamala pale ulipo, na peke yake pale usipokuwepo), faharasa huchapisha kiwango kilichonukuliwa katika vyanzo vya wazi: chaneli za umma za Telegram za maduka ya kubadilisha fedha, sehemu za viwango za wachapishaji wa ndani, mabaraza ya mtandaoni. Kiwango kilichochapishwa ni ukweli; tunahifadhi nambari, wakati na kiungo cha chapisho, kamwe si maandishi.

• Nukuu: nambari moja kutoka chapisho moja la umma: sarafu iliyonukuliwa (ISO 4217), msingi (USD; USDT huhesabiwa kama USD na hutajwa; nukuu za EUR huwekwa kando na hazibadilishwi), upande, kiwango kwa kila kitengo 1 cha msingi, wakati wa chapisho (UTC), kiungo. Kipande cha herufi zisizozidi 200 kuzunguka nambari huhifadhiwa kwa ukaguzi tu na hakionyeshwi kamwe. Chapisho moja linaweza kutoa nukuu kadhaa (nunua na uza, sarafu kadhaa, miji kadhaa).
• Kanuni ya pande. side ni kitendo cha mteja, kama katika faharasa: mteja hununua USD kwa bei ya kuuza ya duka la kubadilisha fedha (nambari ya juu) na huuza USD kwa bei ya kununua ya duka hilo. Chapisho linaloweka lebo ya jozi kinyume hubadilishwa na kuwekewa alama ya imani ya chini. mid ni nukuu isiyo na pande.
• Uchimbaji. Kwanza regular expressions kwa miundo ya kawaida ("USD 1650/1665", "Покупка: 11810 / Продажа: 11860", "$ = ₦1,650", "1 USDT = 41.25 TRY", "Dolar: 49,72", fomu za Dari / Kiarabu / Kiurdu / Kibengali / Kiajemi; maelfu yaliyoandikwa kwa nafasi, apostrofi au nukta; toman = rial 10). Mistari kuhusu viwango rasmi, vya benki kuu, vilivyoorodheshwa kwenye soko la hisa na vya utabiri huruka. Machapisho yenye neno la sarafu na nambari lakini bila mfanano huenda kwa modeli ya lugha kwa makundi, kama data; kila nambari inayorejesha huthibitishwa kama mfanano wa regex.
• Masafa yanayokubalika kwa kila sarafu na msingi: rejea inayotegemea miamala ya siku 30 za mwisho, vinginevyo wastani wa kati wa nukuu za siku 14 za mwisho (≥ 5), vinginevyo thamani ya awali; masafa ni rejea ± 60 %. Nukuu zilizo nje yake huhifadhiwa kama outlier na haziingii kamwe kwenye faharasa; nukuu zilizohifadhiwa kabla masafa hayajakuwepo hukaguliwa upya yanapoonekana.
• Uaminifu wa chanzo (reliability, 0–1, hukokotolewa upya kila siku kwa siku 30 za mwisho):
• usahihi = max(0, 1 − dev / 5 %), dev = wastani wa kati wa |nukuu / rejea − 1|; rejea ni rejea inayotegemea miamala ya siku hiyo hiyo ya UTC pale ipo (chanzo kilichorekebishwa), vinginevyo wastani wa kati wa kuacha-mmoja wa angalau vyanzo vingine viwili kwa sarafu na siku hiyo; bila rejea yoyote, 0.5. Kwa chanzo kilichorekebishwa, mwelekeo ambao kundi zima la vyanzo vya sarafu hiyo hushiriki dhidi ya rejea (mkengeuko wa kati wa vyanzo vingine siku hiyo, angalau viwili kati yake) huondolewa kwanza: soko la fedha taslimu linalonukuu asilimia chache mbali na soko la dola ya kidijitali ni sifa ya soko hilo, si kosa la chanzo kinachoripoti. Kwa hivyo usahihi hupima chanzo kiko umbali gani na maafikiano ya soko; mtawanyiko na outliers huadhibiwa kama hapo awali;
• mabadiliko ya pamoja yenyewe huchapishwa pamoja na siku kama basis_gap_pct = (mid ya vyanzo vingi / kigezo cha marejeo kinachotokana na miamala − 1) × 100: ziada (hasi: punguzo) ya kiwango cha mtaani kilichonukuliwa juu ya kijenzi kinachotokana na miamala siku hiyo, kwa vitendo ni pengo kati ya soko la fedha taslimu na soko la dola za kidijitali. Ni kijenzi cha faharasa, si marekebisho: hakuna mfululizo unaorekebishwa kwa kutumia pengo hilo;
• usafi = 1 − sehemu ya thamani zilizo nje ya kawaida; uthabiti = max(0, 1 − dispersion / 3 %), dispersion = median ya (max − min) ndani ya siku / median ya nukuu za chanzo; mwendelezo = siku zenye nukuu / 20, kiwango cha juu ni 1;
• reliability = 0.5·accuracy + 0.2·cleanliness + 0.15·stability + 0.15·regularity, ndani ya [0.05, 1]. Chanzo chenye nukuu chini ya 5 hubaki na thamani ya kuanzia 0.3. Alama tatu za kila siku mfululizo chini ya 0.2 husitisha chanzo kwa siku 7; kisha hurudi kama mgombea na lazima kipate tena hali ya active (nukuu halali ≥ 5 ndani ya siku 3). Historia huhifadhiwa kwa kila siku.
• Siku (GET /v1/street-index/{cur}/history): mid = median iliyopimwa kwa uaminifu ya mid za machapisho (kununua na kuuza za chapisho moja hupigwa wastani; nukuu moja pekee huhesabiwa kama ilivyo), buy / sell = median zilizopimwa za nukuu husika, spread_pct = (buy − sell) / mid × 100. Siku huchapishwa tu ikiwa na nukuu ≥ 3 kutoka vyanzo ≥ 2; vinginevyo hakuna safu. n_sources, n_quotes, confidence (0–1: nusu kutoka idadi ya vyanzo, 1 ikiwa ni vinne au zaidi; nusu kutoka makubaliano, 1 pale mkengeuko wa median wa mid ni 0 na 0 ukiwa 5 %) na confidence_class (high: vyanzo ≥ 3 vinavyokubaliana ndani ya 2 %; medium: vyanzo ≥ 3; limited: vyanzo vichache zaidi) zinaelezea siku. Mfululizo wa kila saa upo tu kwa saa zenye nukuu ≥ 3.
• Ufikiaji. Funguo za bure: sarafu za kiwango cha bure zenye ucheleweshaji wa siku 1; Pro: sarafu zote; Enterprise: pia nukuu zilizo nyuma ya kila siku pamoja na viungo vya vyanzo vyake (GET /v1/street-index/{cur}/quotes). Siku huhesabiwa upya kila siku kwa siku 45 za mwisho na zinaweza kubadilika vyanzo vinapopimwa upya au kuwekewa alama upya.
• Mapungufu. Machapisho ni yale ambayo vyanzo vimechagua kuchapisha; chanzo kinaweza kuchelewa, kukosea au kuwa cha matangazo ya kibiashara: ndiyo sababu kuna alama ya uaminifu. Ufunikaji wa kila sarafu uko katika n_sources. Si ushauri wa uwekezaji.

Kurasa za sarafu na takwimu za tovuti

• Kila sarafu ina ukurasa wa umma (/rates/{CUR}): kiwango cha saa ya mwisho, mabadiliko, saa 24 za mwisho, chati za siku 90 na mwaka 1, ulinganisho wa kiwango rasmi na cha mtaani pale bidhaa inaposhughulikia sarafu hiyo, siku 30 za mwisho, na takwimu zile zile zinazotolewa na API. Kurasa, /sitemap.xml, /llms.txt na /llms-full.txt huzalishwa kutoka kwenye faharasa; unaponukuu takwimu, taja chanzo kama "EMpulse Street FX Index".
• Tovuti hutunza takwimu zake za wageni bila vidakuzi wala vifuatiliaji vya nje: mitazamo ya kurasa, nchi na tovuti zilizoelekeza wageni hujumlishwa kutoka kwenye kumbukumbu za ufikiaji za seva mara moja kwa saa; anwani za IP hazihifadhiwi (wageni huhesabiwa kupitia hash yenye chumvi inayobadilika kila siku). Nchi ya ziara hutokana na anwani ya IP kwa kutumia hifadhidata ya DB-IP Lite: IP Geolocation by DB-IP (https://db-ip.com), leseni CC BY 4.0.

Mbao za miji na kadi za wabadilishaji fedha

• Ukurasa wa jiji (/rates/{CUR}/{city}) unaonyesha faharasa ya nchi nzima na, chini yake, mbao za ofisi za kubadilishia fedha za jiji hilo zinazochapisha viwango vyao wazi (kurasa na chaneli zao za umma): median ya mbao hizo, idadi ya wabadilishaji walio nyuma yake na daraja la uhakika: limited ikiwa mbao ni chini ya tatu, medium kuanzia tatu, high mbao zinapokubaliana ndani ya 2 %. Ubao wenye umri wa zaidi ya siku tatu hauonyeshwi.
• Kila mbadilishaji mwenye ubao wa umma hupata kadi iliyojengwa kutoka kwenye ubao huo: jina la umma la biashara, jiji lake, tovuti au chaneli yake na viwango inavyochapisha. Hakuna mtu anayerekodiwa: hakuna majina, namba za simu wala hati; mawasiliano pekee yanayohifadhiwa ni anwani wazi ya biashara kwenye tovuti yake yenyewe.
• Biashara hudai kadi yake bila hatua yoyote ya binadamu: kwa msimbo uliowekwa kwenye faili au meta tag kwenye tovuti yake, kwenye chapisho la chaneli yake, kwenye ujumbe kwa bot ya EMpulse kutoka kwa akaunti inayosimamia chaneli, au kwa kiungo kilicho kwenye barua kwenda kwenye anwani wazi. Kadi iliyothibitishwa ina beji, huwekwa kwanza kwenye ubao wa jiji na inaweza kuchapisha viwango vyake yenyewe (amri ya bot, chaneli yake au ufunguo wake mwenyewe).
• Viwango vya biashara yenyewe huonyeshwa tofauti na faharasa, vikiwa na alama kuwa ni vya mbadilishaji mwenyewe. Huingia kwenye faharasa tu kama chanzo kimoja zaidi chenye uaminifu inaoupata (kanuni zile zile za uaminifu kama kwa kila chanzo kingine); kiwango kinachotofautiana na ubao wa jiji kwa zaidi ya umbali unaokubalika hakikubaliwi na hushusha hadhi ya kadi, hakipandishi kamwe. Kukataliwa mara kwa mara husitisha utoaji wa nukuu. Kupitia chanzo hicho, viwango vya wabadilishaji waliothibitishwa pia huhesabiwa katika shughuli ya sarafu, kama chanzo kingine chochote cha kijenzi cha vyanzo vingi.

Korido (GET /v1/corridors/{a}/{b}, /corridors/{A}-{B}, Pro na Enterprise)

Sarafu nyingi za masoko yanayoibukia hubadilishwa moja kwa moja kwa nyingine: som kwa tenge, hryvnia kwa dirham, rupia kwa riyal, katika vikao vya umma, chaneli na mbao za matangazo, bila hatua ya dola. Faharasa husoma matangazo hayo ya umma katika lugha za nchi husika na huchapisha kiwango cha korido cha jozi pamoja na kiwango mtambuka kinachotokana na hatua zake mbili za dola.

• Tangazo ni chapisho moja la umma linalotaja sarafu mbili zisizo dola na bei au kiasi viwili ("куплю сумы за тенге, 100 000 сум за 4 000 тенге", "1 KZT = 25.3 UZS", "vendo pesos por reales"). Tunahifadhi jozi, kiwango (vipimo vya sarafu ya pili kwa kipimo 1 cha ya kwanza), upande wa mwandishi, kiasi kinapotajwa, jiji na daraja la njia ya malipo (fedha taslimu / uhamisho / kadi), wakati na kiungo. Namba za simu, majina ya watumiaji, anwani za barua pepe na viungo vilivyomo ndani ya maandishi huondolewa kabla ya kuhifadhi chochote; waandishi hawarekodiwi kamwe. Kanuni za miundo ya kawaida hutangulia; chapisho lenye sarafu mbili ambazo kanuni hazikuelewa huenda kwa modeli ya lugha kama data, na kila nambari inayorudisha huthibitishwa kama inayopatikana kwa kanuni.
• Uwezekano wa kukubalika. Tangazo hukaguliwa dhidi ya kiwango kinachotokana na hatua mbili za dola za faharasa (b per USD ÷ a per USD) ± 60 %: nambari iliyogeuzwa hugeuzwa upya na kuwekewa kumbukumbu, nambari iliyo nje ya masafa ni ya nje ya kawaida na haiingii kamwe kwenye kiwango. Ofa za dola katika chapisho hilo hilo huachwa kwa faharasa ya dola.
• Siku (rate) ni median iliyopimwa kwa uaminifu ya matangazo halali ya siku ya jozi, pamoja na low na high za siku; sources huhesabu vyanzo huru vya umma vilivyo nyuma yake; confidence ni high kukiwa na vyanzo vitatu au zaidi vinavyokubaliana ndani ya 3 %, medium kukiwa na viwili, limited kukiwa na kimoja au pale hatua ya dola ya jozi bado haina kigezo cha marejeo. Jozi huchapishwa tangu tangazo lake la kwanza; tangazo moja pekee ni limited.
• implied_cross ni kiwango hicho hicho kinachokokotolewa kutoka kwenye viwango viwili vya dola vya faharasa siku hiyo hiyo (kila kimoja kwa umri usiozidi siku tatu); corridor_premium_pct = (rate / implied_cross − 1) × 100, yaani bei ya kwenda moja kwa moja badala ya kupitia dola: chanya inamaanisha korido ni ghali zaidi, hasi ni nafuu zaidi. Pande mbili za jozi ni mfululizo mmoja: b per a na a per b ni kinyume cha kila kimoja, na ndivyo ilivyo kwa ziada hizo.
• Sarafu zisizo na soko la dola. Sarafu isipokuwa na kijenzi chake cha dola lakini inanukuliwa dhidi ya sarafu yenye kijenzi hicho, faharasa hutoa kiwango chake cha dola kupitia korido (a per USD = b per USD ÷ b per a, median iliyopimwa kwa korido hizo za siku). Mfululizo huo uliotokana huingia kwenye kanuni ya shughuli kama kijenzi kingine chochote, ukiwa daraja moja chini ya korido iliyotoka, na haitumiki kamwe kama hatua ya dola ya korido nyingine.
• Ufikiaji. Kurasa za umma zinaonyesha siku ya mwisho; funguo za Pro na Enterprise pia hupata siku ya sasa kwenye API, historia na orodha ya korido ghali zaidi na nafuu zaidi (/v1/corridors/top). Matangazo husomwa tu kutoka vyanzo vya umma ambavyo robots.txt na masharti yake yanaruhusu; vyanzo vinavyokataza usomaji wa kiotomatiki au matumizi tena huachwa nje.

Mapungufu

• Viwango vya mtaani vinaonyesha kile watu wanacholipa kwa kweli kwenye soko la mtaani; si viwango rasmi, vya benki kuu wala vya soko la benki na benki, na vinaweza kutofautiana navyo kwa kiasi kikubwa.
• Mfululizo wenye confidence = limited una mapengo (siku zisizo na thamani au zisizo na mid) na mtikisiko mkubwa zaidi. Kagua confidence na flag kabla ya kutumia thamani.
• Ufunikaji huanza kwa tarehe tofauti kwa sarafu tofauti (coverage_since katika GET /v1/currencies), na sarafu inaweza kuwa coverage_in_progress kwa muda (tazama "Coverage and activity").
• Faharasa hutolewa kwa madhumuni ya taarifa tu na si ushauri wa uwekezaji.