Ìtìlẹ́yìn & FAQ
Wá ìdáhùn sí àwọn ìbéèrè tó wọ́pọ̀, tàbí kí o bá ẹgbẹ́ wa sọ̀rọ̀.
Bá ìtìlẹ́yìn sọ̀rọ̀
Fún ìsanwó, ìbẹ̀rẹ̀ iṣẹ́, ìsopọ̀ API, tabi ìbéèrè mìíràn, kọ̀ọ̀kan rẹ́ ẹ́mèìlì sí wa ní tààrà. A máa ń dáhùn láàárín 1 ọjọ́ iṣẹ́.
Fún ìlérí iṣẹ́ (service-level commitments), rí Tì SLA.
Gbogbo ìbéèrè ni a ń bójútó nípasẹ̀ inbox kan náà: info@fxmacrodata.com.
Ìtìlẹ́yìn fún ìwọlé (Support intake)
Ṣe ètò ìròyìn email tó yára sí i
Fi endpoint ati context ìbéèrè kún un kí a lè ṣàyẹ̀wò àwọn ìṣòro kí ó yá.
Ipò
Ìlera Platform
Fún àwọn ìgbà ìṣẹ̀lẹ̀ (incident timelines) àti àtúnṣe ní ipele kọ̀ọ̀kan, wo feed tó wà níta: fxmacrodata.statuspage.io.
Àwọn ìlékùn ìrànlọ́wọ́ tó ṣe pàtàkì
Gba ìdúró náà kúrò kí o lè lọ lọ́wọ́
Awọn endpoint tó gbajúmọ̀
Bẹ̀rẹ̀ pẹ̀lú API Calls tí ó ní Ìmọ̀ Tó Lágbára
Kọ́ọ̀kan kọ́kọ́ (card) ń so ète iṣẹ́ pọ̀ mọ́ ẹgbẹ́ endpoint kan pàtó àti ibi tí docs ti wà.
Ìpolongo
/api/v1/announcements/{currency}/{indicator}
Àwọn iye ìpapọ̀ ní àkókò kọ̀ọ̀kan pẹ̀lú àkókò ìpapọ̀ ìsọfúnni.
Kalẹ́ńdà Ìpapọ̀
/api/v1/calendar/{currency}
Àwọn ìfilọ́ macro tó ń bọ̀ nípa owó amúyẹ ati àmì.
Forex
/api/v1/forex/{base}/{quote}
Àwọn rẹ́ẹ̀tì spot ìtàn pẹ̀lú àwọn technical overlays tó lè wáyé.
Rates & Àwọn Curve
/api/v1/rate_differentials/{base}/{quote}
Carry spreads, àwọn snapshots curve, àwọn slope proxies, àti àwọn forward segments tí a mú látinú.
COT
/api/v1/cot/{currency}
Ìṣírò positioning tí kò jẹ́ ti òwò lọ́sẹ̀ọ̀sẹ̀ láti ìròyìn CFTC.
Commodities
/api/v1/commodities/{indicator}
Àwọn macro regime analysis tí a fi n lo commodity àti metals series.
Àkókò Ọjà (Market Sessions)
/api/v1/market_sessions
Ìpò ìṣílẹ̀/ìtìsílẹ̀ lọ́wọ́lọ́wọ́ fún àwọn àkókò ìṣòwò FX pàtàkì.
Àwọn ìbéèrè tó wọ́pọ̀
Data & Ìfipá-mọ́ra
Báwo ni data ṣe rí ní ìgbà tí ó ṣẹlẹ̀ (real-time)?
FXMacroData n ṣọba awọn ìpapọ̀ ti o fẹsẹmọṣẹ ti o ni iyanu ati ki o ṣe akọsilẹ ẹri ìpapọ̀ ati ìkójọpọ̀ nibi ti o bá wà. Ipò ìkọkọ́ ti ìfipamọ́ yàtọ̀ sí orísun ati ìpapọ̀; publication_time_status n ṣalaye awọn akoko ìpapọ̀ ti a fọwọ́si, eyi ti a ko ti fọwọ́si, eyi ti a fọwọ́ rọ̀ ninu ìtàn, ati awọn akoko ìpapọ̀ ti a ko mọ.
Àwọn orísun data wo ni a fi kún?
Àwọn ìpamọ́ Macroeconomic wá láti ọ̀dọ̀ àwọn olùgbàgbọ́ àtọwọ́dọ́wọ́, títí kan àwọn àjọ ìṣirò orílẹ̀-èdè, àwọn ìjọba, àti àwọn banki ààbò bíi ECB àti RBA. Ṣàyẹ̀wò gbogbo ìsẹ́rẹ́' metadata orísun fún olùgbékalẹ̀ rẹ̀ àti ìṣe tó ṣe ìpìlẹ̀ rẹ̀.
Ǹjẹ́ mo lè rí data ìtàn?
Bẹ́ẹ̀ ni. Data ìtàn kíkún wà fún ẹni tí ó ní ìforúkọsilẹ̀ Ẹni-Kọ̀kan, Ìṣòwò tàbí Ẹ̀yìn-Ìṣòwò. Àwọn olùlo tí kò forúkọsilẹ̀ lè rí àwọn ìpínlẹ̀-ìgbà-freemium fún 90 ọjọ́ tí ó súnmọ́ ìgbà yìí jùlọ, 15 ìṣẹ́jú lẹ́yìn tí a gbé ìfilọ́lẹ̀ kọ̀ọ̀kan jáde.
Èwo nínú àwọn endpoint ni ọ̀fẹ́ vs èwo ni wọ́n ní owó?
Láìsí kíì API, àti láìsí àkàǹtì tàbí ìpínlẹ̀-ìgbà-ìparí, o lè lo àwọn data ìfilọ́lẹ̀ USD fún 90 ọjọ́ tí ó súnmọ́ ìgbà yìí jùlọ (íròyìn kọ̀ọ̀kan 15 ìṣẹ́jú lẹ́yìn tí a gbé e jáde), kàlẹ́ńdà ìfilọ́lẹ̀ USD, kátalọ́gù data, ìgbà-ìṣòwò, àwọn ìfilọ́lẹ̀-ọ̀rọ̀-àjọ USD tí ó jẹ́ òtítọ́, àti ipò-ìdúró USD COT, títí kan 100 ìbéèrè lójúmọ́. Àwọn ìye-asọtẹ́lẹ̀ (tí USD pẹ̀lú), ìfilọ́lẹ̀-àkókò-gidi, ìtàn kíkún, data tí kì í ṣe USD, àwọn ìye-owó FX, àti ohun-èlò-ìṣòwò nílò kíì API láti inú ètò Ẹni-Kọ̀kan, Ìṣòwò tàbí Ẹ̀yìn-Ìṣòwò (Enterprise).
Ọkan owó (currencies) ló wà tí a ṣe àtìlẹ́yìn fún?
P látari gbogbo rẹ̀, pùlátfọ́mu yìí kòkòró 22 owó ìyàtọ̀, pẹ̀lú àwọn ìfilọ́hùn gbajúmọ̀ ati ìbòwò kátalọ́ tí a ti téjàde lọ́wọ́lọ́wọ́ fún 22 owó ìyàtọ̀ ati ìbòwò kàlẹ́ndà ìtúṣẹ́ tí a téjàde fún 20. Wo àtúnlélò (documentation) fún àlàyé coverage ní ipele endpoint.
Ìsanwó (Billing) & Ìfọwọ́sowọ́pọ̀
Ǹjẹ́ àyẹ̀wò ọ̀f free nílò kẹ́ẹ̀dì kárẹ́dì?
Bẹ́ẹ̀ ni. Àyẹ̀wò ọjọ́ 14 nílò kẹ́ẹ̀dì kárẹ́dì tó tọ̀nà nígbà tí o bá ń ṣe ìforúkọsílẹ̀. Kò ní ṣe ìsanwó rẹ títí tí àyẹ̀wò náà bá parí.
Ǹjẹ́ mo lè fòpin sí rẹ̀ ní ìgbàkìgbà?
Bẹ́ẹ̀, o lè fòpin sí i láti inú àwọn ìtòlẹ́sẹẹsẹ subscription rẹ kí o tó dé ìgbà ìsanwó rẹ tó kàn.
Kí ni ó máa ṣẹlẹ̀ nígbà tí ìgbàyẹ́ ọfẹ́ bá parí?
Ìfọwọ́sowọ́pọ̀ rẹ yóò yí padà sí ètò tí a sanwó ní tìjì-tìjì àyàfi tí o bá pa á rẹ́ nínú ìṣáájú ìparí ìdánwò. O lè ṣàkóso èyí nínú àwọn ìtòjú billing rẹ.
Kí ni yóò ṣẹlẹ̀ tí ọ̀nà ìsanwó mi bá kùnà?
Tí a kò bá lè ṣe ìsanwó, ìsíwájú sí àkọọ́lọ́ ìṣàkóso lè ní ìdíwọ́ títí tí a yóò fi tún ìsọfúnni ìsanwó ṣe. Wo àwọn òfin billing fún àlàyé kíkún.
Àwọn ọ̀nà ìsanwó wo ni a gbà pé a gbà?
A gbà gbogbo kẹ́ẹ̀dì kírẹ́dì pàtàkì (Visa, Mastercard, Amex) nípasẹ̀ apákan ìsanwó Stripe wa tó ṣe ààbò.
Tekiníkà & Ìsopọ̀ (Integration)
Ǹjẹ́ o ṣe àtìlẹ́yìn fún àwọn èdè programming mìíràn?
Bẹ́ẹ̀ ni. Python SDK tó ṣe kedere wà nípasẹ̀ pip install fxmacrodata, àti pé REST API ń ṣiṣẹ́ láti gbogbo èdè — Go, R, Java, C#, MATLAB, Rust, àti bẹ́ẹ̀ bẹ́ẹ̀ lọ. Wo àwọn ìtọ́sọ́nà ìbẹ̀rẹ̀ kánkán fún àwọn àpẹẹrẹ.
Ǹjẹ́ ọ̀kan nínú MCP server wà fún àwọn iranlọ́wọ́ AI?
Bẹ́ẹ̀ ni. FXMacroData ṣe àtìlẹ́yìn fún Model Context Protocol (MCP), tí ó ń jẹ́ kí o lè so Claude, Cursor, àti àwọn irinṣẹ́ AI mìíràn pọ̀ mọ́ àwọn data wa ní tààrà. Wo docs server MCP.
Báwo ni mo ṣe lè fún API requests ní ìdámọ̀ (authenticate)?
Ránṣẹ́ kíì API rẹ nínú orí-ọ̀rọ̀ ìbéèrè: X-API-Key: YOUR_API_KEY. A tún gba Authorization: Bearer. Pe API láti inú server rẹ: kò ránṣẹ́ àwọn header CORS sí àwọn browser. Wá kókó rẹ nínú dashboard ìdarí API lẹ́yìn tí o bá forúkọsílẹ̀.
Kí ni ìtìlẹ́yìn tí ó wà nínú ètò mi?
Gbogbo ètò tí a sanwó fún pẹ̀lú ìtìlẹ́yìn ìméèlì fún ìdàpọ̀ ati àwọn ìbéèrè data. Ìṣòwò fi ìtìlẹ́yìn àkọ́kọ́ kún un, ati àwọn àdéhùn Enterprise le ní àwọn àyànmọ́ SLA àrà ọ̀tọ̀. Wo àwọn àkókò ìdáhùn ìtìlẹ́yìn.
Quant & Backtesting
Ǹjẹ́ data náà wà ní àkókò pàtọ̀ / kò ní àṣìṣe ìṣáájú (lookahead bias)?
Ìtúpalẹ̀ ní àsìkò pàtó dá lórí ẹri tí a tọ́jú fún ọ̀nà ọ̀kan kọ̀ọkan. Yẹ announcement_datetime pẹ̀lú publication_time_status, publication_time_precision, àti vintage_status. Lo as_of pẹ̀lú availability=public tàbí availability=captured láti yan àwọn iye ìtàn tó yẹ, lẹ́yìn náà ṣàyẹ̀wò data_quality.point_in_time_safe. Ìṣẹ́lẹ̀ àkókò lásán kò lè mú àwọn àtúnṣe tó wáyé lẹ́yìn kúrò, bẹ́ẹ̀ ni àkókò ìyọ́jú tàbí ìkójọpọ̀ kò lè fìdí rẹ̀ múlẹ̀ nígbà tí oníbàárà lè kà iye náà nípasẹ̀ API.
Ǹjẹ́ mo lè lo data yìí pẹ̀lú pandas, NumPy, tàbí àwọn framework backtesting?
Bẹ́ẹ̀ ni. Gbogbo ìdáhùn API ń padà wá pẹ̀lú JSON tó ṣe kedere tí ó lè yí padà sí pd.DataFrame. announcement_datetime ati generated_at n lo Unix epoch seconds; awọn iho ti akoko ibi n lo ISO 8601 strings pẹlu offset. Awọn iho nanosecond tun ni awọn iye decimal-string lati tọju iṣẹ ọgbọn. Lo pd.concat()láti so àwọn ìsẹ́rẹ́ tí ó bá mu pọ̀ lẹ́yìn tí a bá ṣàyẹ̀wò àwọn ìṣirò àti ẹri àkókò. Ìsopọ̀ tó mọ àkókò lè lo merge_asof.
Ǹjẹ́ àwọn iye data tí a ṣàtúnṣe máa ń wà ní ìyàtọ̀ sí àwọn ìdirimọ̀ àkọ́kọ́?
Nibi ti a ti tọju wọn, awọn iye vintage n han ni revisions[]. Beere fun revisions=all lati ṣayẹwo itan ti o wà fun iṣẹ kan pato. Fun atunṣe, lo as_of pẹlu revisions=latest lati yan eyi ti o ṣetan julọ ni akoko ti o fẹ. Ṣayẹwo vintage_status ati is_first_release: iye ti a kọkọ́ gba kii ṣe eyi ti olùpapọ̀ gbe jade ni akọkọ'ìtẹ̀ jáde àkọ́kọ́ rẹ̀, bẹ́ẹ̀ sì jẹ́ pé kò sí ìtàn àtúnṣe kíkún fún gbogbo ìsẹ́.
Báwo ni ìtàn data ṣe rí lọ sí ìsinsìnyí?
Ìláti ìtàn (Historical depth) yàtọ̀ nípa apáka (indicator) àti orísun ṣọ́ọ̀bù àárẹ̀. Púpọ̀ nínú àwọn apáka pàtàkì (CPI, GDP, ìdílé rẹ́ẹ̀tì, àìní iṣẹ́) ní ìkákelé 10 ọdún. Àwọn èrè bond àti àwọn apáka kejì kan ní ìtàn kúkúrú ju bẹ́ẹ̀ lọ. Rí àkójọpọ̀ afíwé (indicator catalogue) fún ìl détails ìkíwọlé nípa nǹkan kọ̀ọ̀kan.
Ǹjẹ́ mo lè pín data náà nínú ìwé ìwádìí tabi àwọn ohun èlò?
Àṣẹ àtúnlọ́ṣọ́ dá lórí ètò rẹ. Ètò Individual àti Enterprise ní ìkábalẹ̀ fún lílo inú rẹ nìkan. Àtúnlọ́ṣọ́ Ìṣòwò jẹ́ add-on tí o lè fúnra rẹ ní fún ìfihàn oníbàárà tí ó ṣe kedere. Lẹ́yìn ìdánwò, a óò sanwó USD 10 fún apá kan àwọn olùgbọ́ ní osùsù kan, láti orí apá kan pẹ̀lú ohun tí ìdílé olùgbọ́ rẹ jẹ́. Apá kan ní ìkábalẹ̀ tó tó 100 àwọn olùlo tàbí àwọn tí a ṣírò, tàbí tó tó 1,000 àwọn olùléwọ́ lórí ìránṣẹ́ ayélujára tàbí ìránṣẹ́ ìpolongo gbòògbòò, àti pé gbogbo ibi tí a ṣe àkọsílẹ̀ máa ń fi àwọn apá sí i sí iye tí ó jẹ mọ́ ìṣàkóso àkọọ́lọ́. Títà API ìpassáyà, àwọn faili púpọ̀, ìránṣẹ́ data, àti títà ní ọjà kò tẹ̀lé ètò yìí. Kò sí ìwé ìwé-ẹ̀kọ́, ìfọ̀rọ̀wérọ̀, ìfọwọ́sí, tàbí àkókò ìdúró. Àwọn Ofin Ìṣẹ́gun fún ìsọfúnni kíkún.
Nílò ìrànlọ́wọ́
Ṣì ní àwọn ìbéèrè?
Tí docs tàbí FAQs kò bá ní ìdáhùn sí ohun tí o fẹ́ ṣe, sọ̀rọ̀ sí wa kí o sì fi ọ̀nà endpoint, àkókò ìṣẹ́jú, àti àkókò ìbéèrè rẹ ránṣẹ́.
Ìdí tí àwọn ẹgbẹ́ fi gbẹ́kẹ̀lé rẹ̀
Orísun tó fìdí múlẹ̀
Àwọn iye ìpolongo wá láti ọ̀dọ̀ àwọn olùpolongo gidi, banki ààbò, ati àwọn ọ́fíìsì ìṣírò.
Àkókò ìṣẹ̀lẹ̀ (Release timestamps)
Àwọn ojú ìwé ìpolongo tọ́jú àkókò ìpolongo UTC fún àwọn ìwádìí ìṣẹ̀lẹ̀, dashboard, iṣẹ́ ìwádìí, ati àwọn eto kíkàn.
Ọ̀pọ̀lọpọ̀ ọdún ìtàn
Àwọn àkọsílẹ̀ ní àkókò kọ̀ọ̀kan fi hàn ohun tí a mọ ní ọjọ́ kọ̀ọ̀kan, kí àwọn backtest má baà mú ìsọfúnni ọjọ́ iwájú.