API ng EMpulse Street FX Index
Pang-araw-araw na street exchange rate ng mga pera ng emerging market, naka-quote bilang fiat kada 1 USDT (itinuturing na 1 USD ang USDT): ang rate na aktuwal na binabayaran ng mga tao, hindi ang opisyal. Bawat serye ay may confidence class. Ang buong pamamaraan ay nasa metodolohiya.
Mga field ng isang index row
| Field | Kahulugan | Kailan ito null | Plano |
|---|---|---|---|
buy | Ang weighted average na rate ng araw kung saan bumibili ang kliyente ng USDT gamit ang fiat. | Kulang ang mga punto ng datos ng buy side para sa araw. | Lahat ng plano |
sell | Pareho, para sa panig kung saan nagbebenta ang kliyente ng USDT. | Kulang ang mga punto ng datos ng sell side para sa araw. | Lahat ng plano |
mid | (buy + sell) / 2 kapag parehong panig ay mayroon; kapag isang panig lang ang mayroon, ang rate ng panig na iyon. | Walang panig na may sapat na mga punto ng datos. | Lahat ng plano |
side | Kung aling mga panig ang pinagbabatayan ng mid: both, buy o sell. Ang mid mula sa isang panig ay lumilihis nang humigit-kumulang kalahating spread kumpara sa mid na mula sa dalawang panig. | Walang mid. | Lahat ng plano |
spread_pct | (buy − sell) / mid × 100. | Hindi both ang side. | Lahat ng plano |
confidence | high, medium o limited: ang class ng pera batay sa saklaw nito; ang araw na mas kaunti ang mga punto ng datos kaysa karaniwan ay isang class na mas mababa. Ang limited ay nangangahulugang mas kaunting source o punto ng datos: mas maraming ingay at posibleng may mga puwang. | Hindi kailanman. | Lahat ng plano |
flag | outlier para sa araw na kaunti ang mga punto ng datos at ang mid ay lumilihis sa median na mid ng nakapaligid na ±15 araw nang higit sa 10%. Pinananatili ng ganoong araw ang mga halaga nito ngunit hindi ito isinasama sa mid_7d at sa mga field na chg_*. | Hindi outlier ang araw. | Lahat ng plano |
in_progress | true para sa pinakabagong araw ng isang pera habang kinokolekta pa ang araw at ang mga punto ng datos nito ay malinaw na mas mababa sa karaniwan ng nakaraang 7 araw. | Hindi kailanman. | Lahat ng plano |
mid_7d | Mean ng mga valid na mid sa nakaraang 7 araw sa kalendaryo, kasama ang huling araw. | Walang valid na mid sa window. | Lahat ng plano |
chg_1d_pct | Pagbabago ng mid kumpara sa eksaktong 1 araw sa kalendaryo bago nito, sa porsyento. | Walang valid na mid ang alinman sa dalawang araw. | Lahat ng plano |
chg_7d_pct | Pagbabago ng mid kumpara sa eksaktong 7 araw sa kalendaryo bago nito, sa porsyento. | Walang valid na mid ang alinman sa dalawang araw. | Lahat ng plano |
chg_30d_pct | Pagbabago ng mid kumpara sa eksaktong 30 araw sa kalendaryo bago nito, sa porsyento. | Walang valid na mid ang alinman sa dalawang araw. | Lahat ng plano |
exchange_spread_pct | Gaano kalayo ang pagitan ng mga exchange na nagku-quote ng pera sa araw na iyon: (pinakamataas − pinakamababang exchange mid) / median × 100. Ang lumalawak na spread ay isa sa mga input ng FX Stress Signals. | Wala pang dalawang exchange ang nagku-quote ng pera, o libre ang key. | Pro, Enterprise |
Ang mga petsa ay mga araw sa kalendaryo ng UTC. Hindi kumpleto ang pinakabagong araw hangga't hindi ito nagsasara at maaari itong rebisahin; ang mga flag ng nakaraang 15 araw ay maaaring magbago habang dumarating ang bagong datos.
Mga hourly rate (Pro at Enterprise). Ang GET /v1/rates/CUR/hourly?from=&to= ay nagbabalik ng index kada oras ng UTC (hanggang 31 araw kada request), ang /v1/rates/CUR/hourly/latest ay ang pinakabagong 24 oras ng isang serye, at ang /v1/rates/hourly/latest ay ang huling kumpletong oras ng bawat pera. Ang mga hour row ay may parehong buy, sell, mid, side, spread_pct, confidence at in_progress; ang mga tugon kada pera ay nagdaragdag ng summary kada araw. Ang mga libreng key ay makakatanggap ng 403 tier_not_in_plan.
Multi-source street index. /v1/street-index/*: mga street rate na pinagsama-sama mula sa maraming independiyenteng pampublikong source sa merkado na may confidence score, para sa bawat pera na saklaw ng mga source (parehong key).
Ipadala ang iyong key sa header na X-API-Key. Libre: RUB, UAH, EGP lamang, 100 request kada araw, hanggang sa huling kumpletong araw. Pro: lahat ng currency, 10,000 request kada araw, kasama ang kasalukuyang araw na kasalukuyang tumatakbo pa. Enterprise: ayon sa kontrata. Nagre-reset ang mga limitasyon sa 00:00 UTC.
JSON bilang default; magpadala ng Accept: text/csv o idagdag ang ?format=csv para sa CSV. Ang mga error ay JSON na may error object na naglalaman ng code at message, na may status 400 (maling parameter), 401 (nawawala o di-wastong key), 403 (ang panahon, currency o produkto ay wala sa plano: tier_delay, currency_not_in_plan, tier_not_in_plan, key_frozen), 404 (hindi kilalang currency o route), 429 (rate_limit_exceeded, history_quota_exceeded) o 503.
Ang mga row na mas luma sa 90 araw ay binibilang sa arawang quota kada key (libre: 1,000, pro: 3,000 row kada araw ng UTC); ang buong export ay available sa ilalim ng kasunduang Enterprise. Personal ang mga key; ang awtomatikong bulk download ay magdudulot ng pag-freeze sa key. Tingnan ang mga tuntunin.
Ang mga street rate ay hindi opisyal o interbank rate; ang mga serye na may confidence na limited ay maaaring pabago-bago at may mga puwang. Ang data ay hindi payo sa pamumuhunan.