EMpulse Street FX Index: Metodologiya

EMpulse Street FX Index inkişaf etməkdə olan bazar valyutalarının USDT-yə (1 USD hesab olunur) qarşı gündəlik "küçə" məzənnələrini dərc edir: insanların faktiki ödədiyi məzənnə, rəsmi məzənnə deyil. İndeks əməliyyat əsaslı bazar məlumatlarını ictimai bazar mənbələrindən olan kotirovkalarla birləşdirir; hər seriyanın əminlik sinfi var və məlumatların məhdudiyyətləri onunla birlikdə dərc olunur.

Komponentlər

Bütün məzənnələr 1 USDT üçün fiat valyuta şəklində kotirovka olunur.

Birja əsaslı komponent

• Hansı birjalar. Yalnız təklifləri üçün sənədləşdirilmiş ictimai API dərc edən, hesab olmadan oxuna bilən, qaydaları avtomatik oxumağı və ya yenidən yayımı qadağan etməyən və robots.txt faylı müvafiq endpoint-ə icazə verən birjalar. Qalan hamısı kənarda saxlanılır, hər birjanın qaydaları isə 30 gündən bir yenidən oxunur: qaydaları dəyişən birja özü-özünə kənarlaşır. Rəqəmin arxasındakı birjalar yalnız say kimi (sources) göstərilir; birjaların siyahısı onların razılığı ilə burada dərc olunur və başqa halda heç bir rəqəmə əlavə edilmir.
• Saat. Hər birja, valyuta və tərəf üzrə qiymətə görə ən yaxşı təkliflər (20-yə qədər) ən yaxşı qiyməti, medianı, dərinliyə görə çəkili qiyməti və dərinliyi (təklif olunan məbləğ, USDT ilə) verir. Tərəflər indeks konvensiyasına uyğundur: buy müştərinin rəqəmsal dollar aldığı tərəfdir. Dollar tokeni əvəzinə bitkoini kotirovka edən birja eyni saatın öz ABŞ dolları kitabı vasitəsilə daxil olur (valyuta ilə qiymət ÷ dollar ilə qiymət), beləliklə hər rəqəm dollar məzənnəsidir. Birjalar arasında saatın mid, buy və sell göstəriciləri etibarlılığa görə çəkili medianlardır; exchange_spread_pct = (ən yüksək − ən aşağı birja mid-i) / median × 100, ən azı iki birja olduqda. Gün öz saatlarının medianlarını götürür.
• Birjanın etibarlılığı (0–1, 30 gün üzrə hər gün yenidən hesablanır): dəqiqlik = max(0, 1 − dev / 5 %), burada dev birjanın mid-inin eyni saatda digər birjaların medianından median məsafəsidir (ikidən az digər birja olduqda günün əməliyyat əsaslı referansından); dərinlik həddi (dərinliyin normaya nisbəti) və təzəlik həddi (son gündə məlumatı olan saatlar); 0.5·accuracy + 0.25·depth + 0.25·freshness. Qiymətləri digərlərindən kənarda olan birja (köhnəlmiş və ya manipulyasiya edilmiş kitab) dərhal çəkisini itirir; üç gündəlik bal 0.2-dən aşağı olarsa, birja bir həftəlik dayandırılır.
• Əminlik. Bir-birindən 2 % daxilində olan ən azı üç birja olduqda gün high, ən azı üç birja olduqda medium, daha az olduqda limited sayılır. Gün valyutanın vahid ictimai indeksinə aşağıdakı qayda ilə daxil olur; birjaların kotirovka etdiyi və başqa heç bir komponentin əhatə etmədiyi valyuta yalnız bu komponent vasitəsilə aktiv olur.

Əhatə və aktivlik

Valyutanın indeksi yuxarıdakı komponentlərdən qurulan gündə bir rəqəmdir:

• yalnız bir komponent dərc etdikdə indeks həmin komponentdir;
• bir neçəsi dərc etdikdə ən təzə gün üstünlük qazanır; həmin gün dərc edən komponentlər əminliyə görə çəkilərlə orta hesablanır: əməliyyat əsaslı komponent high / medium / limited gün üçün müvafiq olaraq 1 / 0.6 / 0.3 çəkisi ilə, çoxmənbəli və birja əsaslı komponentlər isə öz əminlik balı (0–1, ən azı 0.1) ilə.

Valyuta, indeksdə son 14 gün ərzində bir gün olduqda aktiv sayılır (/v1/currencies: status = "active", active_since = 14 gündən uzun fasiləsiz məlumat seriyasının cari dövrünün ilk günü). Son günü olmayan valyuta əhatə prosesindədir: onun üçün bazar mənbələri əlavə edirik, dərc olunmuş tarixçəsi əlçatan qalır və son gün yarandıqdan sonra özü aktiv siyahıya qayıdır. Saytın canlı cədvəli yalnız aktiv valyutaları göstərir; tariflərdə göstərilən valyuta sayı aktiv valyutaların sayıdır.

Hər aktiv valyuta üçün son gün aşağıdakıları daxil edir:

• sources: günün arxasındakı müstəqil bazar mənbələrinin sayı (əməliyyat əsaslı komponent bir mənbə sayılır, birja əsaslı komponentin hər birjası bir mənbə sayılır). Sayı iki və ya daha çox olduqda dərc olunur, limited gün üçün isə həmişə dərc olunur ("1 mənbə, məhdud əminlik"); əks halda boşdur (API-də null).
• confidence: son günün sinfi (high / medium / limited, aşağıya baxın); gün üç və ya daha çox gün köhnədirsə, bir sinif aşağı göstərilir.

Valyuta ilk bazar mənbəyindən başlayaraq dərc olunur: bir mənbəli gün limited sayılır və coverage improving qeydini daşıyır (sayt, API, MCP): rəqəm real, qeyri-müəyyənliyi isə bəyan edilib, daha çox mənbə əlavə olunur. medium üçün iki müstəqil mənbə, high üçün 2 % daxilində üst-üstə düşən üç mənbə lazımdır. Birja əsaslı komponent aktivlik qaydasına yalnız sifariş kitablarında saat ərzində ən azı üç müstəqil təklif və iki günlük məlumat göründükdən sonra daxil olur; heç bir məlumat nöqtəsi olmayan valyuta coverage_in_progress qalır.

Gündəlik indeks sahələri (GET /v1/rates/{cur})

• buy: müştərinin fiat valyuta ilə USDT aldığı günün çəkili orta məzənnəsi. Gün üçün məlumat nöqtələri çox az olan tərəf null olur.
• sell: müştərinin USDT satdığı tərəf üçün eyni göstərici.
• mid: həm buy, həm sell mövcud olduqda (buy + sell) / 2. Bazarın yalnız bir tərəfi varsa, mid həmin tərəfin məzənnəsinə bərabərdir (bax: side). Heç bir tərəf yoxdursa, mid null olur.
• side: mid-in əsaslandığı tərəf: both, buy (yalnız buy mövcuddur) və ya sell (yalnız sell mövcuddur); mid olmadıqda null. Bazarın bir tərəfinə əsaslanan mid ikitərəfli ilə müqayisədə təxminən yarım spred qədər sürüşmüş olur, buna görə günləri müqayisə edərkən side-ı nəzərə alın.
• spread_pct: (buy − sell) / mid × 100, yalnız side = "both" olduqda; əks halda null. Adətən müsbətdir; mənfi spred məlumatları məhdud olan günlərdə ola bilər və olduğu kimi dərc olunur.
• confidence: high, medium və ya limited. Hər valyutanın əhatəsindən gələn baza sinfi var (GET /v1/currencies: ən yaxşı əhatə olunan seriyalar üçün high, qalanları üçün medium); məlumat nöqtələri adidan az olan gün bir sinif aşağıdır (high → medium, medium → limited). limited daha az məlumat nöqtəsi deməkdir: daha çox səs-küy, mümkün boşluqlar.
• in_progress: valyutanın son günü üçün true, gün hələ toplanarkən və onun məlumat nöqtələri əvvəlki 7 təqvim günün (yalnız məlumatı olan günlər) normasından açıq şəkildə aşağı olduqda. Belə gün yenidən işlənəcək. Bütün digər günlər false olur.
• mid_7d: son 7 təqvim günü üzrə etibarlı mid dəyərlərinin ədədi ortası, günün özü daxil olmaqla. Etibarlı mid-i olmayan günlər atlanır; heç biri yoxdursa null.

• chg_1d_pct, chg_7d_pct, chg_30d_pct: (mid / mid_N_days_ago − 1) × 100, düz 1, 7 və ya 30 təqvim günü əvvəllə müqayisə. İki gündən birinin etibarlı mid-i yoxdursa (boşluqlar üzərindən keçid edilmir) və ya iki günün side-ı fərqlidirsə (məsələn, both ilə buy), null olur: birtərəfli mid təxminən yarım spred qədər sürüşmüş olur, ona görə belə müqayisə baş verməmiş hərəkəti göstərərdi.

• exchange_spread_pct (Pro və Enterprise): günün birja əsaslı komponentinin birjalararası spredi (yuxarıya baxın); ikidən az birja olduqda null.

"Etibarlı mid" kənar nöqtə kimi işarələnməmiş, null olmayan mid deməkdir.

Hərəkət etməyən tərəf

Bəzən bazarın bir tərəfi hərəkət etməyi dayandırır, digər tərəf isə dəyişən qiymətlərlə əməliyyatlar aparmağa davam edir: bir neçə gün ərzində (gündəlik indeks üçün beş gün) onun median məzənnəsi 0.05 % daxilində qalır və ya həmin tərəfdə hər gün eyni bir qiymətlə bağlanır. Belə qiymət əməliyyat qiyməti deyil, elan olunmuş (kotirovka edilmiş) qiymətdir və onunla canlı tərəf arasındakı ortada yerləşən mid mənasız olardı. Bu halda indeks yalnız hərəkət edən tərəfə əsaslanır: mid həmin tərəfin məzənnəsinə bərabərdir, side onu göstərir (buy və ya sell), baxmayaraq ki, həm buy, həm də sell dərc olunur, spread_pct isə null-dur. Qayda gün-gün tətbiq olunur və sakit tərəf yenidən hərəkət etməyə başlayan kimi özü ləğv olunur; hər iki tərəf eyni dərəcədə hərəkətsiz olduqda (donuq bazar) heç nə dəyişmir. Saatlıq indeks eyni qaydanı 24 saatlıq pəncərə üzrə tətbiq edir.

Kənar göstəricilər

Aşağıdakıların hamısı ödəndikdə gün flag = "outlier" ilə qeyd olunur:

1. onun mid göstəricisi var;
2. onun məlumat nöqtələri azdır (yaxşı əhatə olunmuş gündə böyük dəyişiklik heç vaxt qeyd olunmur: o, real bazar hərəkəti hesab edilir);
3. onun mid göstəricisi ətrafdakı ±15 təqvim günü pəncərəsinin median mid dəyərindən (günün özü istisna olmaqla) 10%-dən çox kənarlaşır;
4. pəncərədə mid göstəricisi olan ən azı 3 digər gün var (əks halda qiymətləndirmək üçün kifayət qədər məlumat yoxdur və gün qeyd olunmur).

Kənar göstərici günləri öz buy, sell, mid və spread_pct dəyərlərini saxlayır ki, müştərilər onları görə bilsin, lakin onlar mid_7d və bütün chg_* hesablamalarından xaric edilir (həm kənar göstərici günün özü üçün, həm də ona istinad edəcək günlər üçün).

Düzəlişlər və vaxt

• Günlər UTC təqvim günləridir. Cari gün 00:00 UTC-yə qədər tamamlanmamış sayılır və gün ərzində yenidən işlənir; onun məlumat nöqtələri normadan açıq-aydın aşağı olduqda in_progress = true ilə işarələnir (yuxarıya baxın).
• Kənar göstərici pəncərəsi geriyə baxdığı kimi 15 gün irəliyə də baxdığı üçün ən son 15 günün qeydləri (və deməli, mid_7d və chg_*) yeni məlumat daxil olduqda dəyişə bilər. Bütün tarixçə hər yenilənmədə yenidən hesablanır.
• Pulsuz API açarları əvvəlki günə qədər məlumat alır; pro və enterprise açarlar cari günü də əhatə edir.
• Hər API açarına çatdırılan seriyalarda əhəmiyyətsiz fərdi fərqlər ola bilər.

Saatlıq indeks (GET /v1/rates/{cur}/hourly, Pro və Enterprise)

Saatlıq indeks gündəlik indeksin saatlıq dəqiqliklə təqdim olunan formasıdır: hər UTC saatı və valyuta üçün buy və sell hər tərəf üzrə saatın bazar əməliyyatlarının çəkili orta məzənnələridir, mid, side və spread_pct gündəlik qaydalara uyğundur, confidence isə valyutanın baza sinfidir.

• Saatlıq seriya necə qurulur. Saatlıq bazar məlumatı olan hər valyutanın seriyası var. Hər UTC saatı üçün saat üzrə dəyəri olduqda əməliyyatlara əsaslanan komponent istifadə olunur; əks halda saat ərzində ən azı 2 müstəqil mənbə kotirovka verdikdə çoxmənbəli komponent (saatın kotirovkalarının etibarlılıq üzrə çəkili medianı, USDT USD kimi sayılır); hər ikisi olduqda saat combined olur: əməliyyatlara əsaslanan dəyər çoxmənbəli medianla çəkilir, onun payı mənbələrinin sayı ilə artır (3 mənbədən başlayaraq yarıya qədər). İkisi arasındakı fərq 3 %-dən çox olduqda saat daha aşağı quality ilə dərc olunur və yoxlanılır. Hər saat öz component dəyərini göstərir (transaction_based, multi_source, combined). Məlumatsız saat göstərilmir: heç nə interpolyasiya edilmir və irəli aparılmır. Valyutanın UTC gündə dəyəri olan saatlarının sayı 6-dan azdırsa (cari gün üçün: son 24 saatda), bu saatlar quality: limited daşıyır və vebsayt onları xətt kimi deyil, nöqtələr kimi çəkir.
• Saatlar və tərəflər. Bazar məlumatı olan hər saat üçün sətir mövcuddur. Tərəfin dərc olunması üçün saatda ən azı 3 məlumat nöqtəsi lazımdır; daha az olduqda tərəf null olur, yalnız bir tərəf mövcud olduqda isə mid həmin tərəfdir (side hansı olduğunu göstərir). Məlumat nöqtələri daha az olan valyutalar üçün indeks dəyəri olan saatlar müvafiq olaraq daha az olur: saatlıq seriyada küy deyil, boşluqlar olur, bu, dizayn etibarilədir.
• Saat daxilində kənar göstəricilər. Saatın aqreqatları saatın öz median məzənnəsindən ±20 % daxilində olan əməliyyatlardan qurulur; sonradan başqa heç nə süzülmür və saatlıq sətirlərdə flag yoxdur. Hərəkət etməyən tərəf qaydası (yuxarıda) 24 saatlıq pəncərə üzrə tətbiq olunur.
• Gündəlik xülasə. Hər valyuta üzrə cavabın hər günü vwap (bütün günün çəkili orta məzənnəsi, hər iki tərəf birlikdə), high və low (ən yüksək və ən aşağı saatlıq mid), hours (indeks dəyəri olan saatlar) və peak_hour (bazar fəallığı ən çox olan saat) göstərir. high və low kifayət qədər məlumat nöqtəsi olan saatlardan (saatda ən azı 5) və günün belələri varsa, yalnız iki tərəfli saatlardan götürülür: bazarın bir tərəfinə əsaslanan mid iki tərəfli olandan təxminən yarım spred qədər aralı yerləşir və ikisini qarışdırmaq bazarda heç vaxt olmamış diapazonu göstərərdi. hours isə hələ də indeks dəyəri olan hər saatı sayır.
• Davam edir. Cari UTC saatı toplanarkən in_progress = true olur və yenidən işlənəcək; GET /v1/rates/hourly/latest yalnız tamamlanmış saatları qaytarır.
• Vaxt. Əməliyyatlara əsaslanan saatlıq sətirlər son üç günü əhatə edən gündəlik yeniləmə ilə gəlir (gecikmiş əməliyyatlar və yenidən hesablamalar həmin zaman götürülür): gündəlik yenilənir, saatlıq dəqiqliklə, real vaxt axını deyil. Çoxmənbəli saatlar gün ərzində son 72 saat üzrə yenidən hesablanır. Tarixçə üfüqündən köhnə saatlıq sətirlər tarixçə kvotasından gündəlik sətirin 1/24 hissəsi qədər çıxılır. İctimai vebsayt saatlıq seriyası olan hər valyutanın son 24 tamamlanmış saatını və son tamamlanmış saatın məzənnəsini göstərir; məlum saatlar arasında qrafik düz xətt çəkir və son dəyəri sağ kənara qədər saxlayır (yalnız göstərmək üçün).

Çoxmənbəli street indeksi (GET /v1/street-index, məhsul "Street Rate Index, çoxmənbəli")

İctimai bazar mənbələrinin street məzənnələrini dərc etdiyi hər valyuta üçün (əməliyyatlara əsaslanan seriya olduqda onunla yanaşı, olmadıqda təkbaşına) indeks açıq mənbələrdə kotirovka edilən məzənnəni dərc edir: valyuta mübadiləsi şirkətlərinin ictimai Telegram kanalları, yerli nəşrlərin məzənnə bölmələri, forumlar. Dərc olunmuş məzənnə faktdır; biz rəqəmi, vaxtı və yazıya keçidi saxlayırıq, mətni isə heç vaxt.

• Kotirovka ictimai yazıdan götürülmüş bir rəqəmdir: kotirovka valyutası (ISO 4217), baza (USD; USDT USD kimi sayılır və qeyd olunur, EUR kotirovkaları ayrıca saxlanılır və konvertasiya olunmur), tərəf, 1 baza vahidi üçün məzənnə, yazının vaxtı (UTC), keçid. Rəqəmin ətrafında ən çoxu 200 simvoldan ibarət fraqment yalnız audit üçün saxlanılır və heç vaxt göstərilmir. Bir yazı bir neçə kotirovka verə bilər (alış və satış, bir neçə valyuta, bir neçə şəhər).
• Tərəf konvensiyası. side indeksdə olduğu kimi müştərinin əməliyyatıdır: müştəri USD-ni mübadilə məntəqəsinin satış qiyməti ilə (daha yüksək rəqəm) alır və USD-ni mübadilə məntəqəsinin alış qiyməti ilə satır. Cütü tərsinə işarələyən yazı çevrilir və daha aşağı etibar səviyyəsi ilə işarələnir. mid tərəfsiz kotirovkadır.
• Çıxarma. Əvvəlcə geniş yayılmış formatlar üçün requlyar ifadələr ("USD 1650/1665", "Покупка: 11810 / Продажа: 11860", "$ = ₦1,650", "1 USDT = 41.25 TRY", "Dolar: 49,72", dari / ərəb / urdu / benqal / fars formaları; boşluqlarla, apostroflarla və ya nöqtələrlə yazılmış minliklər; toman = 10 rial). Rəsmi, mərkəzi bank, birjada kotirovka olunan və proqnoz məzənnələri haqqında sətirlər buraxılır. Valyuta sözü və rəqəmi olan, lakin heç bir uyğunluğu olmayan yazılar dəstələrlə, data kimi dil modelinə göndərilir; onun qaytardığı hər rəqəm requlyar ifadə uyğunluğu kimi yoxlanılır.
• Valyuta və baza üzrə məqbul diapazon: son 30 günün əməliyyatlara əsaslanan referansı, əks halda kotirovkaların son 14 günlük medianı (≥ 5), əks halda başlanğıc dəyər; diapazon referans ± 60 %-dir. Ondan kənar kotirovkalar outlier kimi saxlanılır və heç vaxt indeksə daxil olmur; diapazon mövcud olmamışdan əvvəl saxlanılan kotirovkalar diapazon yarandıqda yenidən yoxlanılır.
• Mənbəyə etibar (reliability, 0–1, son 30 gün üzrə hər gün yenidən hesablanır):
• dəqiqlik = max(0, 1 − dev / 5 %), dev = median |quote / reference − 1|; referans, əgər varsa, eyni UTC günü üçün əməliyyatlara əsaslanan referansdır (kalibrlənmiş mənbə), əks halda həmin valyuta və gün üçün ən azı iki digər mənbənin hər dəfə bir mənbəni çıxarmaqla hesablanan medianı; heç bir referans olmadıqda 0.5. Kalibrlənmiş mənbə üçün həmin valyutanın mənbələr qrupunun referansa nisbətən ümumi payladığı sürüşmə (həmin gün digər mənbələrin median kənarlaşması, onlardan ən azı ikisi) əvvəlcə çıxılır: nağd bazarın rəqəmsal dollar bazarından bir neçə faiz aralı kotirovka verməsi həmin bazarın xüsusiyyətidir, onu bildirən mənbənin xətası deyil. Buna görə dəqiqlik mənbənin bazar konsensusundan nə qədər aralı olduğunu ölçür; dispersiya və kənar göstəricilər əvvəlki kimi cərimələnir;
• ortaq sürüşmənin özü gün üzrə basis_gap_pct = (çoxmənbəli mid / əməliyyat əsaslı istinad − 1) × 100 kimi dərc olunur: həmin gün küçə məzənnəsi kotirovkasının əməliyyat əsaslı komponentə nisbətən mükafatı (mənfi olduqda: endirimi), praktikada nağd bazar ilə rəqəmsal dollar bazarı arasındakı fərq. Bu indeksin komponentidir, düzəliş deyil: heç bir sıra onunla tənzimlənmir;
• təmizlik = 1 − kənar qiymətlərin payı; sabitlik = max(0, 1 − dispersion / 3 %), burada dispersion = mənbənin kotirovkalarının medianına nisbətdə gün daxili (maks − min) medianıdır; müntəzəmlik = kotirovkaları olan günlər / 20, ən çoxu 1;
• reliability = 0.5·accuracy + 0.2·cleanliness + 0.15·stability + 0.15·regularity, [0.05, 1] daxilində. 5-dən az kotirovkası olan mənbə 0.3 başlanğıc qiymətini saxlayır. Ardıcıl üç gündəlik bal 0.2-dən aşağı olarsa, mənbə 7 günlüyə dayandırılır; sonra namizəd kimi qayıdır və active statusunu yenidən qazanmalıdır (3 gün ərzində ≥ 5 etibarlı kotirovka). Tarixçə gün üzrə saxlanılır.
• Gün (GET /v1/street-index/{cur}/history): mid = paylaşımlardakı mid-lərin etibarlılıqla çəkili medianı (bir paylaşımın alışı və satışı ortalanır; tək kotirovka olduğu kimi sayılır), buy / sell = müvafiq kotirovkaların çəkili medianları, spread_pct = (buy − sell) / mid × 100. Gün yalnız ≥ 2 mənbədən ≥ 3 kotirovka olduqda dərc olunur; əks halda sətir olmur. n_sources, n_quotes, confidence (0–1: yarısı mənbələrin sayından, dörd və daha çox olduqda 1; yarısı uyğunluqdan, mid-lərin median kənarlaşması 0 olduqda 1, 5 % olduqda 0) və confidence_class (high: 2 % daxilində uyğun gələn ≥ 3 mənbə; medium: ≥ 3 mənbə; limited: daha az mənbə) günü xarakterizə edir. Saatlıq sıra yalnız ≥ 3 kotirovkası olan saatlar üçün mövcuddur.
• Giriş. Pulsuz açarlar: pulsuz səviyyəyə daxil olan valyutalar, 1 gün gecikmə ilə; Pro: bütün valyutalar; Enterprise: həmçinin hər günün arxasındakı kotirovkalar mənbə linkləri ilə (GET /v1/street-index/{cur}/quotes). Günlər son 45 gün üçün hər gün yenidən hesablanır və mənbələrin balı və ya işarəsi yenidən dəyişdirildikdə dəyişə bilər.
• Məhdudiyyətlər. Paylaşımlar mənbələrin dərc etməyi seçdiyi məlumatdır; mənbə gecikə, yanlış ola və ya reklam xarakterli ola bilər: etibar balı məhz bunun üçündür. Hər valyuta üzrə əhatə n_sources göstəricisindədir. İnvestisiya məsləhəti deyil.

Valyuta səhifələri və sayt statistikası

• Hər valyutanın ictimai səhifəsi var (/rates/{CUR}): son saatın məzənnəsi, dəyişikliklər, son 24 saat, 90 günlük və 1 illik qrafiklər, məhsulun valyutanı əhatə etdiyi hallarda rəsmi və küçə məzənnəsinin müqayisəsi, son 30 gün və API-nin təqdim etdiyi eyni göstəricilər. Səhifələr, /sitemap.xml, /llms.txt və /llms-full.txt indeksdən yaradılır; göstəricəyə istinad edərkən mənbə kimi «EMpulse Street FX Index» adını göstərin.
• Sayt cookie faylları və xarici izləyicilər olmadan öz ziyarət statistikasını aparır: səhifə baxışları, ölkələr və yönləndirən mənbələr serverin giriş jurnalından saatda bir dəfə aqreqasiya olunur; IP ünvanları saxlanılmır (ziyarətçilər gündəlik dəyişən duzla hash vasitəsilə sayılır). Ziyarətin ölkəsi IP ünvanından DB-IP Lite bazası ilə müəyyən edilir: IP Geolocation by DB-IP (https://db-ip.com), lisenziya CC BY 4.0.

Şəhər lövhələri və mübadilə məntəqələrinin kartları

• Şəhər səhifəsi (/rates/{CUR}/{city}) ölkə üzrə indeksi və onun altında məzənnələrini açıq dərc edən (ictimai səhifələri və kanalları) şəhər mübadilə məntəqələrinin lövhələrini göstərir: bu lövhələrin medianı, arxasındakı mübadilə məntəqələrinin sayı və etibar sinfi: üç lövhədən az olduqda limited, üçdən başlayaraq medium, lövhələr 2 % daxilində uyğun gələndə high. Üç gündən köhnə lövhə göstərilmir.
• Açıq lövhəsi olan hər mübadilə məntəqəsi həmin lövhə əsasında yaradılmış kart alır: biznesin ictimai adı, şəhəri, saytı və ya kanalı və dərc etdiyi məzənnələr. Heç bir şəxs qeydə alınmır: ad, telefon nömrəsi və ya sənəd yoxdur; saxlanılan yeganə əlaqə biznesin öz saytındakı açıq ünvandır.
• Biznes kartını heç bir insan addımı olmadan təsdiq edir: saytındakı faylda və ya meta teqdə yerləşdirilmiş kod, kanalının paylaşımında, kanalı idarə edən hesabdan EMpulse botuna göndərilən mesajda və ya açıq ünvana göndərilən məktubdakı link vasitəsilə. Təsdiqlənmiş kartda nişan olur, şəhər lövhəsində birinci yerdə durur və öz məzənnələrini dərc edə bilər (bot komandası, kanalı və ya öz açarı).
• Öz məzənnələri indeksdən ayrı göstərilir və mübadilə məntəqəsinin özünün məzənnəsi kimi qeyd olunur. İndeksə yalnız qazandığı etibarlılıqla bir əlavə mənbə kimi daxil olur (hər digər mənbə ilə eyni etibar qaydaları); şəhər lövhəsindən ehtimal olunan məsafədən çox fərqlənən məzənnə qəbul edilmir və kartın mövqeyini aşağı salır, heç vaxt yüksəltmir. Təkrar rədlər kotirovka verməyi dayandırır. Bu mənbə vasitəsilə təsdiqlənmiş mübadilə məntəqələrinin öz məzənnələri də çoxmənbəli komponentin hər hansı digər mənbəsi kimi valyutanın aktivliyinə sayılır.

Koridorlar (GET /v1/corridors/{a}/{b}, /corridors/{A}-{B}, Pro və Enterprise)

İnkişaf etməkdə olan bazarların bir çox valyutası bir-biri ilə birbaşa dəyişdirilir: som tengəyə, qrivna dirhəmə, rupi riyala; ictimai forumlarda, kanallarda və elan lövhələrində, dollar ayağı olmadan. İndeks həmin ictimai elanları ölkələrin dillərində oxuyur və cütün koridor məzənnəsini onun öz dollar ayaqlarının nəzərdə tutduğu çarpaz məzənnə ilə yanaşı dərc edir.

• Elan dollardan fərqli iki valyutanı və qiyməti və ya iki məbləği göstərən bir ictimai paylaşımdır («куплю сумы за тенге, 100 000 сум за 4 000 тенге», «1 KZT = 25.3 UZS», «vendo pesos por reales»). Cütü, məzənnəni (birinci valyutanın 1 vahidinə düşən ikinci valyuta vahidləri), müəllifin tərəfini, göstərildikdə məbləğləri, şəhəri və ödəniş üsulu sinfini (nağd / köçürmə / kart), vaxtı və linki saxlayırıq. Telefon nömrələri, istifadəçi adları, e-poçt ünvanları və mətn daxilindəki linklər hər hansı məlumat saxlanmazdan əvvəl silinir; müəlliflər heç vaxt qeydə alınmır. Geniş yayılmış formalar üçün qaydalar birinci tətbiq olunur; qaydaların anlamadığı iki valyutalı paylaşım məlumat kimi dil modelinə ötürülür və onun qaytardığı hər rəqəm qayda uyğunluğu kimi yoxlanılır.
• Məntiqlilik. Elan indeksin iki dollar ayağının nəzərdə tutduğu məzənnə (b per USD ÷ a per USD) ± 60 % ilə yoxlanılır: tərsinə çevrilmiş rəqəm çevrilir və qeyd olunur, diapazondan kənar rəqəm kənar qiymətdir və məzənnəyə heç vaxt daxil olmur. Eyni paylaşımdakı dollar təklifləri dollar indeksinə buraxılır.
• Gün (rate) cütün həmin günkü etibarlı elanlarının etibarla çəkili medianıdır, günün low və high dəyərləri ilə; sources onun arxasındakı müstəqil ictimai mənbələri sayır; confidence 3 % daxilində uyğun gələn üç və ya daha çox mənbə olduqda high, iki mənbə olduqda medium, bir mənbə olduqda və ya cütün dollar ayağının hələ istinadı olmadıqda limited olur. Cüt ilk elanından etibarən dərc olunur; tək elan limited olur.
• implied_cross eyni gün indeksin iki dollar məzənnəsindən hesablanan eyni məzənnədir (hər biri ən çox üç gün köhnə); corridor_premium_pct = (rate / implied_cross − 1) × 100: dolların üzərindən getmək əvəzinə birbaşa getməyin qiyməti: müsbət dəyər koridorun daha bahalı, mənfi dəyər daha ucuz olduğunu bildirir. Cütün iki istiqaməti bir sıradır: b per a və a per b bir-birinin tərsidir, mükafatlar da belədir.
• Dollar bazarı olmayan valyutalar. Valyutanın öz dollar komponenti olmadıqda, lakin dollar komponenti olan valyutaya qarşı kotirovka edildikdə, indeks onun dollar məzənnəsini koridor vasitəsilə çıxarır (a per USD = b per USD ÷ b per a, günün belə koridorları üzrə çəkili median). Bu çıxarılmış sıra aktivlik qaydasına hər hansı digər komponent kimi daxil olur, mənbə olduğu koridordan bir etibar sinfi aşağıda olur və heç vaxt başqa koridorun dollar ayağı kimi istifadə edilmir.
• Giriş. İctimai səhifələr son günü göstərir; Pro və Enterprise açarları həmçinin API-də cari günü, tarixçəni və ən bahalı və ən ucuz koridorların siyahısını (/v1/corridors/top) alır. Elanlar yalnız robots.txt faylı və şərtləri icazə verən ictimai mənbələrdən oxunur; avtomatlaşdırılmış oxunmanı və ya təkrar istifadəni qadağan edən mənbələr kənarda saxlanılır.

Məhdudiyyətlər

• Küçə məzənnələri insanların küçə bazarında faktiki ödədiyini əks etdirir; onlar rəsmi, mərkəzi bank və ya banklararası məzənnələr deyil və onlardan əhəmiyyətli dərəcədə fərqlənə bilər.
• confidence = limited olan sıralarda boşluqlar (dəyəri və ya mid göstəricisi olmayan günlər) və daha yüksək səs-küy var. Dəyərdən istifadə etməzdən əvvəl confidence və flag sahələrini yoxlayın.
• Əhatə müxtəlif valyutalar üçün müxtəlif tarixlərdən başlayır (GET /v1/currencies sorğusunda coverage_since), valyuta bir müddət coverage_in_progress statusunda ola bilər («Əhatə və aktivlik» bölməsinə baxın).
• İndeks yalnız məlumat məqsədilə təqdim olunur və investisiya məsləhəti deyil.