Ukusekelwa & FAQ
Thola izimpendulo zemibuzo evamile, noma uxhumane nethimba lethu.
Xhumana nokusekelwa
Ngezinye izikhathi zokukhokha, ukungena, ukuhlanganiswa kwe-API, noma noma iyiphi eminye imibuzo, usithumelele nge-imeyili ngqo. Ngokuvamile siphendula phakathi kwe-1 usuku lwebhizinisi.
Mayelana nezibopho sezinga lenkonzo, bheka i- Sekela u-SLA.
Yonke imibuzo iphendulwa ngomabhokisi okuthumela imiyalezo owodwa: info@fxmacrodata.com.
Ukwamukela ukusekelwa (Support intake)
Bhala i-imeyili yokuhlunga esheshayo
Faka i-endpoint kanye nomongo wemibhalo ukuze sikwazi ukuxazulula izinkinga ngokushesha.
Isimo
Impilo ye-Platform
Ukuze uthole imininingwane yezikhathi zezigameko kanye nezibuyekezo ezingadingeki, bheka i-feed yangaphandle: fxmacrodata.statuspage.io.
Izixhumanisi zobusizo ezihamba phambili
Thola usizo ngokushesha okukhulu
Ama-endpoints ajwayelekile
Qala Ngezibikezelo ezinemilayezo ekhulu ze-API Calls
Ikhadi ngalinye lihlanganisa inhloso yesici nomndeni we-endpoint ogcwele kanye nendawo ye-docs.
Izimemezelo
/api/v1/announcements/{currency}/{indicator}
Izimemezelo ze-point-in-time release values kanye nezikhathi zokukhipha.
Ikalenda Yokukhipha
/api/v1/calendar/{currency}
Izimemezelo zemakholo ezizayo ngokuthembela ngezimali ngezindikator.
Forex
/api/v1/forex/{base}/{quote}
Izinga lomlando (historical spot rates) nezinye izinketho ze-technical overlays.
Amazinga (Rates) & Amakhefu (Curves)
/api/v1/rate_differentials/{base}/{quote}
Izikhali zezikwele (Carry spreads), izithombe zemigqa (curve snapshots), izibonakaliso zemigqa (slope proxies), nezicucu zezikhathi ezitholakala ngokubalwa (derived forward segments).
COT
/api/v1/cot/{currency}
Ukubikwa kwe-weekly non-commercial okuvela ku-CFTC.
Izimpahla (Commodities)
/api/v1/commodities/{indicator}
Uhlu lwe-Commodity ne-metals olusetshenziswa ekuhlaziyweni kwe-macro regime.
Izikhathi zeMakethe
/api/v1/market_sessions
Isimo samanje sokuvula/ukuvala samavindile amakhulu e-FX session.
Imibuzo evame ukubuzwa
Idatha & Ukubhekwa (Coverage)
Ingabe idatha isemthethweni ngesikhathi sangempela?
FXMacroData ukhanda ukukhishwa okusekelwayo okusemthethweni futhi igcina ubufakazi bokukhipha nokuqoqwa lapho kutholakala khona. Ukubhekwa kwesikhathi kuncike emtholampilo nasokukhiwa; i-publication_time_status ihlonza izikhathi zokukhipha eziqinisekisiwe, ezingaqinisekile, ezilinganiselwe zesikhathi esidlule, nezaziwayo.
Iyiphi imithombo yedatha ehlanganisiwe?
Izimemezelo zezomnotho ezikhulu zivela kubaphansi boqobo, kuhlanganise nezinhlangano zezibalo zesizwe, izinhlangano zikahulumeni, kanye namabhange ophakathi njenge-ECB kanye ne-RBA. Hlola i-series ngayinye' imethadata yomthombo ukuze uthole umphandisi wayo nomlinganiselo osemqoka.
Ngingakwazi ukufinyelela emlandweni wemininingwane?
Yebo. I-data ye-historical ephelele itholakala nge-subscription ye-Individual, Business noma Enterprise. Abasebenzisi abangakawubhalisile (non-subscribed) bangangena e-freemium time-series endpoints zamahlanu e-90 izinsuku zakamuva, iminithi e-15 ngemuva kokuba i-release ishicilelwe.
Iziphi i-endpoints ezikhululekile umahluko nazo ezikhokhelwayo?
Ngaphandle kwe-key ye-API, futhi ngaphandle kwe-account noma i-expiry, ungasebenzisa i-data ye-announcement ye-USD zamahala zamahlanu e-90 izinsuku zakamuva, (iminithi e-15 ngemuva kokushicilelwa), i-calendar ye-release ye-USD, i-catalogue ye-data, ama-session emakethe, ama-press release asemthethweni we-USD, kanye ne-positioning ye-USD COT, kufika e-100 requests ngosuku. Ama-value e-forecast (kuhlanganiswe i-USD), ama-release e-real-time, i-history ephelele, i-data engesi-USD, ama-rate e-FX, kanye nama-commodities adinga i-key ye-API kusukela e-plan ye-Individual, Business noma Enterprise.
Zingaphi izimali ezisekela?
Inkunduma ihlanganisa i-22 zemali ngokujikelele, lapho izaziso zomphakathi nokugubuzelwa kwekatalogi okwamanje kushicilelwe i-22 zemali nokugubuzelwa kwekhalenda yokukhishwa kushicilelwe i-20. Bheka i- imibhalo (documentation) ukuze uthole imininingwane yokukhonjwa ye-endpoint.
Ukukhokha (Billing) & Ukubhalisa
Ingabe isilinganiso esikhululekile sidinga ikhadi lekredeethi?
Yebo. Isilinganiso se-day 14 sidinga ikhadi lekredeethi esebenzayo lapho ubhalisa. Ngeke ukhokhwe kuze kube sekupheleni kwesilinganiso.
Ngingakanciphisa noma nini?
Yebo, ungakwazi ukuyayeka ezilungiselweni zakho zokubhalisa ngaphambi kokuba kuqale isikhathi sakho sokukhokhela esilandelayo. Akukho mbuzo obuzobuzwa.
Kwenzekani lapho ukuzivivinya mahhala kuphela?
Ukubhalisa kwakho kuguquka ngokuzenzakalelayo kube yiphulani (paid plan) ngaphandle uma kukhishwa ngaphambi kokuphela kokuhlola. Ungakwenza lokhu kuzilungisa kuzilungiselelo zakho zokukhokha.
Kwenzekani uma indlela yami yokukhokha ihluleka?
Uma ukukhokha kungakwazi ukucatshangelwa, ukufinyelela kwenkonzo kungase kukhithimuke kuze kube yilapho imininingwane yokukhokha ivuselelwe. Bheka imibandela yokukhokha ukuze uthole imininingwane.
Iyiphi imikhono yokukhokha eyamukelekayo?
Samukela zonke amakhadi e-credit amakhulu (Visa, Mastercard, Amex) nge-Stripe payment processor wethu ophephile.
Ezobuchwepheshe & Ukuhlanganiswa
Ingabe usesekela ezinye izilimi zokuhlela (programming languages)?
Yebo. I-Python SDK esemthethweni itholakala ngo- pip install fxmacrodata, kanye i-REST API isebenza kuzo zonke izilimi — Go, R, Java, C#, MATLAB, Rust, nangaphezulu. Bheka i- izihlobo zokuqala ngokushesha ngeziibonelo.
Ingabe kukhona i-MCP server ye-AI assistants?
Yebo. FXMacroData isekela i-Model Context Protocol (MCP), ikuvumela ukuba uxhumanise uClaude, uCursor, nezinye amathuluzi AI ngqo nedatha yethu. Bheka i Amadokhumenti esevini ye-MCP.
Ngingenza kanjani ukuthi izicelo ze-API ziqinisekiswe?
Thumela i-key yakho ye-API ku-request header: X-API-Key: YOUR_API_KEY. I-Authorization: Bearer nayo yamukeleka. Biza i-API kusuka ku-server yakho: ayithumeli ama-header e-CORS kuma-browser. Thola i-key yakho ku-dashboard yokuphatha i-API ngemuva kokubhalisa.
Yikuphi ukusekelwa okufakwe kwi-plan yami?
Zonke izinhlelo ekhokhelwe zihlanganisa ukusekelwa nge-email ngokuhlanganisa nemibuzo yedatha. IBhizinisi yengeza ukusekelwa okubalulekile, kanti izivumelwano ze-Enterprise zingahlanganisa izinketho ze- SLA ezikhethekile. Bheka izinhloso zokuphendula ukusekelwa.
Quant & Backtesting
Ingabe idatha iyeyo-point-in-time / engenabo ubuqili bokubona okuzokwenzeka?
I-Point-in-time replay incike ebuntwini obugcinwe ngebala ngalinye. Hlola announcement_datetime kanye ne-publication_time_status, i-publication_time_precision, kanye ne-vintage_status. Sebenzisa i-as_of ne-availability=public noma i-availability=captured ukuze ukhethe amani emlandweni afanele, bese ubheka i-data_quality.point_in_time_safe. Isihlungi sesikhathi sodwa asisusi ukubuyekeza okungemva kwalokho, futhi isikhathi sokukhipha noma sokubopha asibonisi ukuthi ikhasimende lingafunda nini inani nge-API.
Ngingakusebenzisa yini lolu daba ne-pandas, i-NumPy, noma ama-framework e-backtesting?
Yebo. Zonke izimpendulo ze-API zibuyisela i-JSON ehlanzekile eguqula ngqo ku- pd.DataFrame. i-announcement_datetime ne-generated_at zisebenzisa ama-Unix epoch seconds; amafeyisi wesikhathi sendawo asebenzisa izinhlobo ze-ISO 8601 ezinokushintshashintsha. Amafeyisi e-nanosecond anezinhlobo ze-decimal-string futhi ukuze kugcinwe ukunemba. Sebenzisa pd.concat()ukuze bahlanganise izinhlobo ezihambisana ngemva kokuhlola izintela nemibhalo yesikhathi. Ama-joins aqaphela isikhathi angasebenzisa merge_asof.
Ingabe izinqubo zemibalo ezilungisiwe zigcinwe ngokuhlukile ekukhishweni kokuqala?
Lapho kugcinwe khona, ama-value vintages abonakala ku revisions[]. Cela ukuthi revisions=all ukuze uhlole umlando otholakala kokuqaphelwa. Ukuze udlale kabusha, sebenzisa i-as_of ne-revisions=latest ukuze ukhethe i-vintage yokugcina efanele ngesikhathi sakho sokunquma. Hlola i-vintage_status kanye ne-is_first_release: inani eliqale kakhulu elithathwe akusona necessarily umphathi'ukushicilelwa kwokuqala, futhi umlando wonke wokubuyekeza awutholakali kuwo wonke umkhakha.
Imbali yemidatha iqala kangakanani emuva?
Ukujula komlando kuncike kwi-indicator kanye nomthombo webhange eliphakeme. Izindikator eziyinhloko eziningi (CPI, GDP, i-policy rate, ukungasebenzi kwemisebenzi) zikubekela okungenani ama-10 onya. ikatalogi ye-indicator ngenxa yeminingwane yokubhekwa kwama-metric.
Ingabe ngingaphinda ngabalalise idatha ezincwadini zocwaningo noma ezimaphahlameni emikhiqizo?
Imithetho yokudayisa kabusha incike ohlelweni lwakho. I-Individual kanye ne-Enterprise kukhuluma ngokusebenzisa kwakho kwangaphakathi. I-Commercial Redistribution iyisandiswa (add-on) sokuzenzela sokukhombisa amakhasimende ngendlela efundekayo enikezwayo. Emva kokuzivivinya (trial), ikhokhwa ku USD 10 ngesigaba somph аудиens ngenyanga, iqala esigabeni esisodwa noma ngabe usayizi womph аудиens wakho unjani. Isigaba siqobela kuze kufike ku 100 abasebenzisi noma abatholayo ababiliwe, noma kuze kufike ku 1,000 abalandeli abaveziwe ku-public social noma i-broadcast feed, kanti yonke indawo eyenziwe (registered surface) inikeza izigaba ku-account-level quantity eyodwa. I-Raw API pass-through, amafayela amaningi (bulk files), ama-data feeds, kanye nokudayisa emakethe (marketplace resale) akufakiwe. Akukho sicelo, ukucela isilinganiso, uhlu lwemivume, noma isikhathi sokulinda. Bheka Imibandela Yezinkonzo ngenxa yeminingwane egcwele.
Udinga usizo
Usanemibuzo?
Uma ama-docs noma ama-FAQs engakubandakanyi okudingayo, uxhumane nathi futhi ufake indlela ye-endpoint, isikhathi seminyaka, nesikhathi sokucela.
Kungani amaqembu ekholelwa kuyo
Imithombo esemthethweni
Amanani okukhiphwa avela kubaphulisi abasemthethweni, amabhange aphakathi, kanye namahhovisi ezibalo.
Izikhathi zokukhishwa (Release timestamps)
Amalayini okumemezela agcina izikhathi zokukhiphwa ze-UTC ukwenzela ukucwaninga kwemibiko, ama-dashboard, imisebenzi yocwaningo, nezinhlelo eziphila.
Iminyaka eminingi yomlando
Imarekhodi ye-Point-in-time iveza okwakwaziwa ngosuku ngalunye, ukuze ama-backtests angasebenzisi imininingwane yakusasa.