ತ್ವರಿತ ಆರಂಭ (Quickstart)
ಯಾವುದೇ ಭಾಷೆಯಲ್ಲಿ ಪ್ರಾರಂಭಿಸಿ
FXMacroData API ಒಂದು ಸರ್ವರ್-ಸೈಡ್ ಬಳಕೆಗೆ ಮೀಸಲಾದ ಪ್ರಮಾಣಿತ JSON REST API ಆಗಿದೆ. HTTP ಬೆಂಬಲವಿರುವ ಯಾವುದೇ ಭಾಷೆ ಕೆಲಸ ಮಾಡುತ್ತದೆ. USD ಘೋಷಣೆಯ ಡೇಟಾ, USD ಬಿಡುಗಡೆ ಕ್ಯಾಲೆಂಡರ್ ಮತ್ತು ಡೇಟಾ ಕ್ಯಾಟಲಾಗ್ ಕೀ ಇಲ್ಲದೆಯೇ ಉಚಿತವಾಗಿ ಲಭ್ಯವಿದೆ: ಇತ್ತೀಚಿನ 90 ದಿನಗಳು, 15-ನಿಮಿಷಗಳ ಬಿಡುಗಡೆ ವಿಳಂಬದೊಂದಿಗೆ, ದಿನಕ್ಕೆ 100 ವಿನಂತಿಗಳವರೆಗೆ. ಮುನ್ಸೂಚನೆ ಮೌಲ್ಯಗಳು (USD ಸೇರಿದಂತೆ), ಉಳಿದ ಎಲ್ಲಾ ಕರೆನ್ಸಿಗಳು, ನೈಜ-ಸಮಯದ ಬಿಡುಗಡೆಗಳು ಮತ್ತು ಸಂಪೂರ್ಣ ಇತಿಹಾಸಕ್ಕೆ API ಕೀ ಅಗತ್ಯವಿದೆ, ಇದನ್ನು X-API-Key header. ಏನು ಉಚಿತವಾಗಿದೆ ಎಂದು ನೋಡಿ
ಬೇಸ್ URL
https://api.fxmacrodata.com
ಅಥೆಂಟಿಕೇಶನ್
X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY
ಹಳೆಯದಾದ (legacy) ?api_key= ಕ್ವೆರಿ ಪ್ಯಾರಾಮೀಟರ್ ಅನ್ನು ಕೈಬಿಡಲಾಗಿದೆ: URL ಗಳಲ್ಲಿನ ಕೀಗಳು ಲಾಗ್ಗಳಲ್ಲಿ ಉಳಿಯುತ್ತವೆ.
ಪ್ರತಿಕ್ರಿಯೆಯ ರೂಪಾಂತರ
JSON (Content-Type: application/json)
openapi-generator-cli 40+ ಭಾಷೆಗಳಲ್ಲಿ ಕ್ಲೈಂಟ್ಗಳನ್ನು ಸ್ವಯಂಚಾಲಿತವಾಗಿ ರಚಿಸಲು.
Accept-Encoding: gzip ಪ್ರತಿ ವಿನಂತಿಯ ಮೇಲೆ (8–12× ಸಣ್ಣ ಪೇಲೋಡ್ಗಳು), ಮರುಬಳಕೆ ಮಾಡಿ ETag ರೆಸ್ಪಾನ್ಸ್ ಹೆಡರ್ ಇನ್ If-None-Match ಪುನರಾವರ್ತಿತ ಪೋಲ್ಗಳ ಮೇಲೆ (ಹಿಂತಿರುಗಿಸುತ್ತದೆ 304 Not Modified ಯಾವುದೇ ಬಾಡಿ ಇಲ್ಲದೆ), ಮತ್ತು ಪಾಸ್ ಮಾಡಿ ?limit=50 ಇಂತಹ ಸಿಂಗಲ್-ಇಂಡಿಕೇಟರ್ ಎಂಡ್ಪಾಯಿಂಟ್ಗಳ ಮೇಲೆ /v1/announcements/usd/inflation ಅಥವಾ /v1/predictions/usd/inflation ನಿಮಗೆ ಇತ್ತೀಚಿನ ಸಾಲುಗಳು ಮಾತ್ರ ಬೇಕಾದಾಗ. ಸಂಪೂರ್ಣ ಉಲ್ಲೇಖವನ್ನು ನೋಡಿ →
limit ಗರಿಷ್ಠ 100. ವರೆಗೆ ಸ್ವೀಕರಿಸುತ್ತದೆ ಪೂರ್ಣ ಶ್ರೇಣಿಯನ್ನು ಸಂಗ್ರಹಿಸಲು, ಈ ವಿನಂತಿಯನ್ನು ಪುನರಾವರ್ತಿಸಿ offset ಗೆ ಹೊಂದಿಸಲಾಗಿದೆ pagination.next_offset until pagination.has_more is false. Python ಲೂಪ್ ಅನ್ನು ನೋಡಿ ↓
fetch() ವೆಬ್ ಪುಟದಿಂದ ಇದನ್ನು ಮಾಡುವುದು ಬ್ರೌಸರ್ನಿಂದ ನಿರ್ಬಂಧಿಸಲ್ಪಟ್ಟಿದೆ. ನಿಮ್ಮ ಬ್ಯಾಕೆಂಡ್ನಿಂದ FXMacroData ಅನ್ನು ಕರೆಯಿರಿ ಮತ್ತು API ಕೀಲಿಯನ್ನು ಕ್ಲೈಂಟ್-ಸೈಡ್ ಕೋಡ್ನಿಂದ ಹೊರಗೆ ಇರಿಸಿ.
core_pce USD ಗಾಗಿ ಅಸ್ತಿತ್ವದಲ್ಲಿದೆ ಆದರೆ ಪ್ರತಿ ಕರೆನ್ಸಿಗೂ ಇಲ್ಲ. ಕರೆನ್ಸಿ ಬೆಂಬಲಿಸುವ ಪ್ರತಿ ಸ್ಲಗ್ ಅನ್ನು ಪಟ್ಟಿ ಮಾಡಿ GET /v1/data_catalogue/{currency}, ಉದಾಹರಣೆಗೆ /v1/data_catalogue/usd. ಒಂದು 200 ಯಾರ data ಅರೇ ಖಾಲಿಯಾಗಿದೆ ಮತ್ತು ಯಾವುದು ಹೊತ್ತೊಯ್ಯುತ್ತದೆ no_data.error_code: NO_DATA_IN_REQUESTED_WINDOW ಅಂದರೆ ಸ್ಲಗ್ ಮಾನ್ಯವಾಗಿದೆ ಮತ್ತು ವಿನಂತಿಸಿದ ದಿನಾಂಕ ವಿಂಡೋ ಮಾತ್ರ ಖಾಲಿಯಾಗಿದೆ — ವಿಸ್ತರಿಸಿ start_date/end_date ಬದಲಿಗೆ URL ಅನ್ನು ಬದಲಾಯಿಸುವುದು ಅಥವಾ ಮರುಪ್ರಯತ್ನಿಸುವುದು. ಒಂದು 404 ಎಂದರೆ ಕರೆನ್ಸಿ ಅಥವಾ ಇಂಡಿಕೇಟರ್ ಸ್ಲಗ್ ತಪ್ಪಾಗಿದೆ.
data_quality ಆಬ್ಜೆಕ್ಟ್. ಬ್ಯಾಕ್ಟೆಸ್ಟ್ಗಳು ಮತ್ತು ಸಾಂಸ್ಥಿಕ ವರದಿಗಾಗಿ, ಪರಿಶೀಲಿಸಿ point_in_time_safe, has_announcement_datetime, source_type, ಮತ್ತು is_stale. point_in_time_safe ವಿಂಡೋದಲ್ಲಿನ ಯಾವುದೇ ಸಾಲು ಸರಣಿಯ ಅಳತೆ ಮಾಡಲಾದ ಬಿಡುಗಡೆ ವಿಳಂಬದಿಂದ ಪಡೆದ ಪ್ರಕಟಣಾ ಸಮಯವನ್ನು ಹೊಂದಿದ್ದರೆ ಅದು ಯಾವಾಗಲೂ ಸುಳ್ಳು (false) ಆಗಿರುತ್ತದೆ, ಆದ್ದರಿಂದ ಪರಿಶೀಲಿಸಿ assumed_release_time_count ಮತ್ತು ಪ್ರತಿ-ಅಂಶದ release_time_assumed ತಪ್ಪು ಎಂದು ಪರಿಗಣಿಸುವುದಕ್ಕಿಂತ ಮೊದಲು ಫ್ಲ್ಯಾಗ್ ಮಾಡಿ.
ಮಾರ್ಕೆಟ್ಪ್ಲೇಸ್ ಪ್ರವೇಶ
FXMacroData ರಿಂದ RapidAPI ವರೆಗೆ ಬಳಸಿ
RapidAPI ಎಂಬುದು FXMacroData REST API ಗಾಗಿ ಒಂದು ಐಚ್ಛಿಕ ಮಾರುಕಟ್ಟೆ ಚಾನಲ್ ಆಗಿದೆ. FXMacroData ಡೇಟಾವನ್ನು ಒದಗಿಸುತ್ತದೆ; RapidAPI ನಿಮ್ಮ ಮಾರುಕಟ್ಟೆ ಚಂದಾದಾರಿಕೆ, API ಕೀ, ವಿನಂತಿ ಕೋಟಾ ಮತ್ತು ಬಿಲ್ಲಿಂಗ್ ಅನ್ನು ನಿರ್ವಹಿಸುತ್ತದೆ. ಈ ಚಾನಲ್ ಮೂಲಕ ವಿನಂತಿಗಳಿಗಾಗಿ ಯಾವುದೇ ಪ್ರತ್ಯೇಕ FXMacroData ಖಾತೆ ಅಥವಾ ಕೀ ಅಗತ್ಯವಿಲ್ಲ.
- ತೆರೆಯಿರಿ ಅಧಿಕೃತ FXMacroData ಪಟ್ಟಿ ಮತ್ತು ಒಂದು ಯೋಜನೆಯನ್ನು ಆರಿಸಿ. ಪ್ರಸ್ತುತ ಕವರೇಜ್, ಕೋಟಾಗಳು ಮತ್ತು ದರ ಮಿತಿಗಳಿಗಾಗಿ ಬೆಲೆ ಟ್ಯಾಬ್ ಅನ್ನು ಪರಿಶೀಲಿಸಿ.
- ಎಂಡ್ಪಾಯಿಂಟ್ ಪ್ಲೇಗ್ರೌಂಡ್ನಿಂದ ನಿಮ್ಮ RapidAPI ಕೀ ಅನ್ನು ಕಾಪಿ ಮಾಡಿ ಮತ್ತು ಅದನ್ನು ನಿಮ್ಮ ಸರ್ವರ್ ಪರಿಸರದಲ್ಲಿ ಈ ಕೆಳಗಿನಂತೆ ಸಂಗ್ರಹಿಸಿ
RAPIDAPI_KEY. - ವಿನಂತಿಗಳನ್ನು ಇಲ್ಲಿಗೆ ಕಳುಹಿಸಿ
https://fxmacrodata1.p.rapidapi.comಕೆಳಗೆ ತೋರಿಸಿರುವಂತೆ ಎರಡೂ RapidAPI ಹೆಡರ್ಗಳೊಂದಿಗೆ.
curl --request GET \ --url "https://fxmacrodata1.p.rapidapi.com/v1/announcements/usd/inflation?limit=3" \ --header "X-RapidAPI-Key: $RAPIDAPI_KEY" \ --header "X-RapidAPI-Host: fxmacrodata1.p.rapidapi.com"
ಮಾರ್ಕೆಟ್ಪ್ಲೇಸ್ ಎಂಡ್ಪಾಯಿಂಟ್ ವ್ಯಾಪ್ತಿ
ಪಟ್ಟಿ ಮಾಡುವಿಕೆಯಲ್ಲಿ ಘೋಷಣೆಗಳು, ಬಿಡುಗಡೆ ಕ್ಯಾಲೆಂಡರ್ಗಳು, ಡೇಟಾ ಕ್ಯಾಟಲಾಗ್, ದೈನಂದಿನ FX ದರಗಳು, COT ಸ್ಥಾನೀಕರಣ, ಕೇಂದ್ರ-ಬ್ಯಾಂಕ್ ಸುದ್ದಿ, ಮಾರುಕಟ್ಟೆ ಅವಧಿಗಳು ಮತ್ತು ಆರೋಗ್ಯ ತಪಾಸಣಿಯನ್ನು ಒಳಗೊಂಡಿದೆ. ಕರೆನ್ಸಿ ಮತ್ತು ಇತಿಹಾಸದ ಪ್ರವೇಶವು ನಿಮ್ಮ RapidAPI ಯೋಜನೆಯನ್ನು ಅವಲಂಬಿಸಿದೆ. ಬೆಂಬಲಿತ ಸೂಚಕ ಸ್ಲಗ್ಗಳನ್ನು ಕಂಡುಹಿಡಿಯಲು ಕ್ಯಾಟಲಾಗ್ ಬಳಸಿ.
ನೇರ FXMacroData ಪ್ರವೇಶ
ಈ ಪುಟದಲ್ಲಿರುವ ಇತರ ಉದಾಹರಣೆಗಳು ಬಳಸುತ್ತವೆ api.fxmacrodata.com ಮತ್ತು ಒಂದು FXMacroData X-API-Key ಅಗತ್ಯವಿದ್ದಾಗ. ಕೀಗಳು ಮತ್ತು ಚಂದಾದಾರಿಕೆಗಳು ಚಾನಲ್ಗಳ ನಡುವೆ ಪ್ರತ್ಯೇಕವಾಗಿವೆ. RapidAPI ಚಂದಾದಾರಿಕೆಯು ಪಟ್ಟಿ ಮಾಡಲಾದ REST ಎಂಡ್ಪಾಯಿಂಟ್ಗಳನ್ನು ಒಳಗೊಳ್ಳುತ್ತದೆ; ವೆಬ್ಸೈಟ್ ಚಂದಾದಾರಿಕೆಗಳು, MCP, ಮುನ್ಸೂಚನೆಗಳು, ಸ್ಟ್ರೀಮಿಂಗ್ ಮತ್ತು webhooks ಪ್ರತ್ಯೇಕ ಕೊಡುಗೆಗಳಾಗಿವೆ.
ನಿಮ್ಮ ಕೀ ಅನ್ನು ಬ್ರೌಸರ್ ಕೋಡ್ ಮತ್ತು ಸಾರ್ವಜನಿಕ ರೆಪೊಸಿಟರಿಗಳಿಂದ ದೂರವಿಡಿ. ದೀರ್ಘವಾದ ಫಲಿತಾಂಶಗಳ ಸೆಟ್ಗಳಿಗಾಗಿ, ಅನುಸರಿಸಿ pagination.next_offset until pagination.has_more is false ಆಗಿದೆ. ನಿಮ್ಮ API ಕೀ ಅನ್ನು ಎಂದಿಗೂ ಸಪೋರ್ಟ್ಗೆ ಕಳುಹಿಸಬೇಡಿ.
ಮೊದಲ API ಕರೆ
ತ್ವರಿತ ವಿನಂತಿ (Quick Request)
ಮೊದಲ ತುಣುಕು ಇದ್ದಕ್ಕಿದ್ದಂತೆ ಚಲಿಸುತ್ತದೆ: USD ಡೇಟಾಕ್ಕೆ ಯಾವುದೇ ಕೀ ಅಗತ್ಯವಿಲ್ಲ, ಬಿಡುಗಡೆಯಾದ 15 ನಿಮಿಷಗಳ ನಂತರ ನೀಡಲಾಗುತ್ತದೆ. ಸೇರಿಸಿ X-API-Key ಎಲ್ಲಾ 22 ಕರೆನ್ಸಿಗಳು ಮತ್ತು ರಿಯಲ್-ಟೈಮ್ ವಿತರಣೆಗಾಗಿ, ಇದನ್ನು ಸರ್ವರ್, ಸ್ಕ್ರಿಪ್ಟ್ ಅಥವಾ ನೋಟ್ಬುಕ್ನಿಂದ ಕಳುಹಿಸಲಾಗುತ್ತದೆ.
# USD inflation, no key: 15-minute delay, most recent 90 days
curl "https://api.fxmacrodata.com/v1/announcements/usd/inflation?limit=5"
# EUR inflation: add X-API-Key for all 22 currencies and real-time releases
curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/announcements/eur/inflation"
Python ವಿನಂತಿಗಳು
ನಕಲಿಸಬಹುದಾದ Python API ವಿನಂತಿಗಳು
ನಿಮಗೆ SDK ವ್ರ್ಯಾಪರ್ ಬದಲಿಗೆ ಕಚ್ಚಾ API ವಿನಂತಿ ಬೇಕಾದಾಗ ಈ ನೇರ REST ಉದಾಹರಣೆಗಳನ್ನು ಬಳಸಿ. ರಕ್ಷಿತ ಮಾರ್ಗಗಳಲ್ಲಿ ಮಾತ್ರ YOUR_API_KEY ಅನ್ನು ಬದಲಾಯಿಸಿ.
USD ಹಣದುಬ್ಬರ ಮಾರುಕಟ್ಟೆ ಒಮ್ಮತ
ನೈಜ ಘೋಷಣೆಗಳಿಗೆ ಜೋಡಿಸಲಾದ Consensus, ಸಮೀಕ್ಷೆ, ಕೇಂದ್ರ-ಬ್ಯಾಂಕ್, IMF, ಮತ್ತು FXMacroData ಮುನ್ಸೂಚನೆಗಳು.
import requests
url = "https://api.fxmacrodata.com/v1/predictions/usd/inflation"
headers = {"X-API-Key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers, timeout=20)
response.raise_for_status()
payload = response.json()
print(payload.get("data", payload))
known-at ಟೈಮ್ಸ್ಟಾಂಪ್ಗಳೊಂದಿಗೆ USD ಹಣದುಬ್ಬರ
ಪಾಯಿಂಟ್-ಇನ್-ಟೈಮ್ ಬ್ಯಾಕ್ಟೆಸ್ಟ್ಗಳಿಗಾಗಿ ಸಾರ್ವಜನಿಕ USD ಹಣದುಬ್ಬರ ದಾಖಲೆಗಳು.
import requests
url = "https://api.fxmacrodata.com/v1/announcements/usd/inflation"
response = requests.get(url, timeout=20)
response.raise_for_status()
payload = response.json()
print(payload.get("data", payload))
EUR/USD FX ಸ್ಪಾಟ್ ಇತಿಹಾಸ
ಜೋಡಿ ಚಾರ್ಟ್ಗಳು, ಮಾಡೆಲ್ಗಳು ಮತ್ತು ಬಿಡುಗಡೆ ಓವರ್ಲೇಗಳಿಗಾಗಿ ದೈನಂದಿನ FX ಬೆಲೆ ಇತಿಹಾಸ.
import requests
url = "https://api.fxmacrodata.com/v1/forex/eur/usd"
headers = {"X-API-Key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers, timeout=20)
response.raise_for_status()
payload = response.json()
print(payload.get("data", payload))
AUD ಪಾಲಿಸಿ-ದರದ ಇತಿಹಾಸ
ನೋ-ಲುಕಹೆಡ್ ಸಂಶೋಧನೆಗಾಗಿ ಬಿಡುಗಡೆ ಸಮಯದೊಂದಿಗೆ ಕೇಂದ್ರ-ಬ್ಯಾಂಕ್ ನಿರ್ಧಾರದ ಇತಿಹಾಸ.
import requests
url = "https://api.fxmacrodata.com/v1/announcements/aud/policy_rate"
headers = {"X-API-Key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers, timeout=20)
response.raise_for_status()
payload = response.json()
print(payload.get("data", payload))
JPY ಮುಂಬರುವ ಬಿಡುಗಡೆ ವೇಳಾಪಟ್ಟಿ
ಅಲರ್ಟ್ಗಳ ಯೋಜನೆ, ಮಾಡೆಲ್ ರಿಫ್ರೆಶ್ಗಳು ಮತ್ತು ಟ್ರೇಡಿಂಗ್ ರಿವ್ಯೂಗಳಿಗಾಗಿ UTC, ಮಾರುಕಟ್ಟೆ-ಸ್ಥಳೀಯ ಮತ್ತು ವಿನಂತಿಸಿದ-ಟೈಮ್ಜೋನ್ ಕ್ಷೇತ್ರಗಳೊಂದಿಗೆ ಮುಂಬರುವ ಮ್ಯಾಕ್ರೋ ಈವೆಂಟ್ಗಳು.
import requests
url = "https://api.fxmacrodata.com/v1/calendar/jpy"
params = {
"timezone": "Asia/Tokyo",
}
headers = {"X-API-Key": "YOUR_API_KEY"}
response = requests.get(url, params=params, headers=headers, timeout=20)
response.raise_for_status()
payload = response.json()
print(payload.get("data", payload))
ಚಿನ್ನದ ಕಮೋಡಿಟಿ ಬೆಲೆಗಳು
ದೈನಂದಿನ ಮೌಲ್ಯಗಳು ಮತ್ತು ಬದಲಾವಣೆಯ ಕ್ಷೇತ್ರಗಳೊಂದಿಗೆ ಅಧಿಕೃತ ಬೆಲೆಬಾಳುವ ಲೋಹಗಳ ಸಮಯದ ಸರಣಿ.
import requests
url = "https://api.fxmacrodata.com/v1/commodities/gold"
headers = {"X-API-Key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers, timeout=20)
response.raise_for_status()
payload = response.json()
print(payload.get("data", payload))
Python
ಅಧಿಕೃತವನ್ನು ಇನ್ಸ್ಟಾಲ್ ಮಾಡಿ fxmacrodata PyPI (1.2.x) ನಿಂದ ಪ್ಯಾಕೇಜ್. ಸಿಂಕ್ ಮತ್ತು ಅಸಿಂಕ್ ಕ್ಲೈಂಟ್ಗಳು ಸರಳ JSON ಡಿಕ್ಷನರಿಗಳನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತವೆ, ಅವು ನೇರವಾಗಿ pandas ಗೆ ಲೋಡ್ ಆಗುತ್ತವೆ. Client() ಯಾವುದೇ ಕೀ ಓದುಗಳಿಲ್ಲದೆ ಉಚಿತ USD ಹಂತವನ್ನು ಬಳಸುತ್ತದೆ; ಪಾಸು api_key ಪ್ರತಿ ಇತರ ಕರೆನ್ಸಿ ಮತ್ತು ರಿಯಲ್-ಟೈಮ್ ವಿತರಣೆಗಾಗಿ.
SDK ಅನ್ನು ಬಳಸುವುದು
from fxmacrodata import Client # USD inflation — no key needed: 15-minute delay, most recent 90 days data = Client().get_indicator("usd", "inflation") print(data["data"][0]) # Add X-API-Key for all 22 currencies and real-time releases client = Client(api_key="YOUR_API_KEY") # EUR policy rate — requires API key rate = client.get_indicator("eur", "policy_rate") # Forex price data — requires API key fx = client.get_fx_price("usd", "jpy")
REST API ಅನ್ನು ನೇರವಾಗಿ ಬಳಸಲಾಗುತ್ತಿದೆ
import requests resp = requests.get( "https://api.fxmacrodata.com/v1/announcements/usd/inflation", timeout=30, ) resp.raise_for_status() payload = resp.json() print(payload["data_quality"]["point_in_time_safe"], payload["data"][0])
ಸಂಪೂರ್ಣ ಇತಿಹಾಸದ ಮೂಲಕ ಪೇಜಿಂಗ್ ಮಾಡಲಾಗುತ್ತಿದೆ
import requests URL = "https://api.fxmacrodata.com/v1/announcements/eur/inflation" HEADERS = {"X-API-Key": "YOUR_API_KEY"} rows, offset = [], 0 while True: resp = requests.get( URL, params={"limit": 100, "offset": offset}, headers=HEADERS, timeout=30, ) resp.raise_for_status() page = resp.json() rows.extend(page["data"]) if not page["pagination"]["has_more"]: break offset = page["pagination"]["next_offset"] print(len(rows), "rows")
Async ಕ್ಲೈಂಟ್
import asyncio from fxmacrodata import AsyncClient async def main(): async with AsyncClient(api_key="YOUR_API_KEY") as client: data = await client.get_indicator("eur", "inflation") print(data) asyncio.run(main())
ಮುನ್ಸೂಚನೆಗಳು & ಮುನ್ಸೂಚನೆಗಳು
ಆ /v1/predictions/{currency}/{indicator} ಎಂಡ್ಪಾಯಿಂಟ್ ಮಾರುಕಟ್ಟೆ ಒಮ್ಮತ ಸಮೀಕ್ಷೆಗಳು, ಕೇಂದ್ರ-ಬ್ಯಾಂಕ್ ಪ್ರಕ್ಷೇಪಣೆಗಳು, IMF ವರ್ಲ್ಡ್ ಎಕನಾಮಿಕ್ ಔಟ್ಲುಕ್ ಮತ್ತು ವೃತ್ತಿಪರ-ಮುನ್ಸೂಚಕ ಸಮೀಕ್ಷೆಗಳಿಂದ ಮುನ್ಸೂಚನೆ ಡೇಟಾವನ್ನು ಫೋರ್ಕಾಸ್ಟ್ ಮಾಡುತ್ತದೆ. ನಿರ್ದಿಷ್ಟ ಕರೆನ್ಸಿ ಮತ್ತು ಸೂಚಕಕ್ಕಾಗಿ ಮುನ್ಸೂಚನೆಗಳನ್ನು ವಿನಂತಿಸಲಾಗುತ್ತದೆ, ಉದಾಹರಣೆಗೆ https://api.fxmacrodata.com/v1/predictions/usd/inflation; ಕರೆನ್ಸಿ-ಮಾತ್ರದ ಮುನ್ಸೂಚನೆ ವಿನಂತಿಗಳನ್ನು ಬೆಂಬಲಿಸುವುದಿಲ್ಲ. ಪ್ರತಿ ಮುನ್ಸೂಚನೆಯು ಅದರ ಘೋಷಣೆಗೆ ಲಿಂಕ್ ಆಗಿದೆ announcement_id, ಆದ್ದರಿಂದ ನೀವು ಮುನ್ಸೂಚನೆಗಳನ್ನು ಸಾಕ್ಷಾತ್ಕರಿಸಿಕೊಂಡ ವೀಕ್ಷಣೆಗಳೊಂದಿಗೆ ಸೇರಿಸಬಹುದು.
prediction_type="fxmacrodata" ಇದು FXMacroData-ಜನರೇಟ್ ಮಾಡಿದ ಅಂದಾಜಾಗಿದೆ; ನಿಜವಾದ ಕಂಪೈಲ್ಡ್ konsensus ಅನ್ನು ಹೀಗೆ ಲೇಬಲ್ ಮಾಡಲಾಗಿದೆ market_consensus. ಮುನ್ಸೂಚನೆಯ ಲಭ್ಯತೆಯು ಬಿಡುಗಡೆಯ ಆಧಾರದ ಮೇಲೆ ಬದಲಾಗುತ್ತದೆ — ಪರಿಶೀಲಿಸಿ ವ್ಯಾಪ್ತಿ ಮ್ಯಾಟ್ರಿಕ್ಸ್. ಲುಕ್-ಅಹೆಡ್-ಫ್ರೀ ಸಂಶೋಧನೆಗಾಗಿ, ಇದನ್ನು ಅನುಸರಿಸಿ ಪಾಯಿಂಟ್-ಇನ್-ಟೈಮ್ ಬ್ಯಾಕ್ಟೆಸ್ಟಿಂಗ್ ಮಾರ್ಗದರ್ಶಿ.
/v1/predictions/coverage/{currency}. ಒಂದು ಟ್ರಯಲ್ ಅಥವಾ ಪೇಯ್ಡ್ ಕೀಲಿ ದೃಢೀಕರಣದ ಮೌಲ್ಯಗಳನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತದೆ.
Python — ಮುನ್ಸೂಚನೆಗಳನ್ನು ಪಡೆಯಿರಿ ಮತ್ತು ನೈಜ ಮೌಲ್ಯಗಳೊಂದಿಗೆ ಜೋಡಿಸಿ
import requests HEADERS = {"X-API-Key": "YOUR_API_KEY"} # Predictions for USD inflation — requires API key preds = requests.get( "https://api.fxmacrodata.com/v1/predictions/usd/inflation", headers=HEADERS, timeout=30, ).json() for group in preds["data"]: print(group["announcement_id"], group["date"]) for p in group["predictions"]: print(f" {p['prediction_source_label']}: {p['predicted_value']}") # Filter by prediction type market = requests.get( "https://api.fxmacrodata.com/v1/predictions/usd/inflation", params={"prediction_type": "market_consensus"}, headers=HEADERS, timeout=30, ).json() # Join predictions with actuals using announcement_id actuals = requests.get( "https://api.fxmacrodata.com/v1/announcements/usd/inflation", headers=HEADERS, timeout=30, ).json() actuals_by_id = {row["announcement_id"]: row for row in actuals["data"]} for group in preds["data"]: actual = actuals_by_id.get(group["announcement_id"]) if actual: print(f"{group['date']}: actual={actual['val']}, forecast={group['predictions'][0]['predicted_value']}")
cURL — ಮಾದರಿಯ ಮೂಲಕ ಮುನ್ಸೂಚನೆಗಳನ್ನು ಪಡೆಯಿರಿ
# Which sources forecast USD indicators — free, no key curl "https://api.fxmacrodata.com/v1/predictions/coverage/usd" # All USD inflation predictions — requires API key curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/predictions/usd/inflation" # Filter by prediction type: market_consensus, imf_weo, central_bank_forecast, survey curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/predictions/usd/inflation?prediction_type=market_consensus" # EUR policy-rate predictions curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/predictions/eur/policy_rate"
Prediction ವಿಧಗಳ ಉಲ್ಲೇಖ
| prediction_type | ವಿವರಣೆ |
|---|---|
| market_consensus | ಲಭ್ಯವಿದ್ದಲ್ಲಿ, ಸಂಕಲಿತ ಮಾರುಕಟ್ಟೆ ಅಥವಾ ಅರ್ಥಶಾಸ್ತ್ರಜ್ಞರ ಘಟನೆಯ ಒಮ್ಮತ |
| market_prediction | ವೃತ್ತಿಪರ-ಮುನ್ಸೂಚಕ ಪಾಯಿಂಟ್ ಪ್ರಿಡಿಕ್ಷನ್ |
| model_nowcast | ಕೇಂದ್ರ-ಬ್ಯಾಂಕ್ ಅಥವಾ ರಿಸರ್ವ್-ಬ್ಯಾಂಕ್ ಮಾಡೆಲ್ ನೌಕಾಸ್ಟ್ |
| ಸಮೀಕ್ಷೆ | ವೃತ್ತಿಪರ ಮುನ್ಸೂಚಕರ ಕೇಂದ್ರ-ಬ್ಯಾಂಕ್ ಸಮೀಕ್ಷೆ (ಉದಾಹರಣೆಗೆ ECB SPF) |
| central_bank_forecast | ಅಧಿಕೃತ ಕೇಂದ್ರ-ಬ್ಯಾಂಕ್ ಪ್ರಕ್ಷೇಪಣೆ (ಉದಾಹರಣೆಗೆ RBNZ MPS, BoC MPR) |
| central_bank_projection | ಅಧಿಕೃತ ಕೇಂದ್ರ-ಬ್ಯಾಂಕ್ ಪ್ರಕ್ಷೇಪಣೆ |
| imf_weo | IMF ವರ್ಲ್ಡ್ ಎಕನಾಮಿಕ್ ಔಟ್ಲುಕ್ ಪ್ರಕ್ಷೇಪಣೆ |
| fxmacrodata | ಕೇಂದ್ರ-ಬ್ಯಾಂಕ್ ಮಾರ್ಗದರ್ಶನ, ಸಮೀಕ್ಷೆಗಳು ಮತ್ತು ಐತಿಹಾಸಿಕ ಪ್ರವೃತ್ತಿಗಳನ್ನು ಸಂಯೋಜಿಸುವ FXMacroData-ಜನರೇಟ್ ಮಾಡಿದ ಮುನ್ಸೂಚನೆ |
cURL
ಇನ್ಸ್ಟಾಲ್ ಅಗತ್ಯವಿಲ್ಲ. ಯಾವುದೇ ಟರ್ಮಿನಲ್ನಿಂದ ಕೆಲಸ ಮಾಡುತ್ತದೆ.
# USD inflation — no-key evaluation, up to 100 requests/day curl "https://api.fxmacrodata.com/v1/announcements/usd/inflation" # EUR policy rate — send your API key in the X-API-Key header curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/announcements/eur/policy_rate" # Release calendar for Australia — requires API key curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/calendar/aud" # Release calendar converted to a requested IANA timezone curl "https://api.fxmacrodata.com/v1/calendar/usd?indicator=gdp&timezone=America/Sao_Paulo" # Forex price history — requires API key curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/forex/usd/jpy" # Data catalogue (discover available indicators for USD) curl "https://api.fxmacrodata.com/v1/data_catalogue/usd"
JavaScript / TypeScript
ಇದು Node.js (18+), Deno ಮತ್ತು Bun ನಲ್ಲಿ ಸರ್ವರ್-ಸೈಡ್ನಲ್ಲಿ ಕೆಲಸ ಮಾಡುತ್ತದೆ. API ಯು CORS ಹೆಡರ್ಗಳನ್ನು ಕಳುಹಿಸುವುದಿಲ್ಲ, ಆದ್ದರಿಂದ ಇದನ್ನು ಬ್ರೌಸರ್ ಕೋಡ್ನಿಂದ ಬದಲಿಗೆ ನಿಮ್ಮ ಬ್ಯಾಕೆಂಡ್ನಿಂದ ಕರೆಯಿರಿ.
ಅಧಿಕೃತ npm ಕ್ಲೈಂಟ್
import { FXMacroDataClient } from "@fxmacrodata/client"; const client = new FXMacroDataClient({ apiKey: "YOUR_API_KEY", }); // Public endpoint example const usdInflation = await client.announcements("usd", "inflation"); // Non-USD endpoint example (requires paid key) const eurRate = await client.announcements("eur", "policy_rate"); console.log(usdInflation, eurRate);
Fetch ಅನ್ನು ನೇರವಾಗಿ ಬಳಸುವುದು
// USD inflation — no-key evaluation, up to 100 requests/day const res = await fetch( "https://api.fxmacrodata.com/v1/announcements/usd/inflation" ); const data = await res.json(); console.log(data); // With API key for non-USD const API_KEY = process.env.FXMD_API_KEY; const eur = await fetch( "https://api.fxmacrodata.com/v1/announcements/eur/policy_rate", { headers: { "X-API-Key": API_KEY } } ); console.log(await eur.json());
ಹೋಗಿ
ಯಾವುದೇ ಬಾಹ್ಯ ಪ್ಯಾಕೇಜ್ಗಳ ಅಗತ್ಯವಿಲ್ಲ — ಸ್ಟ್ಯಾಂಡರ್ಡ್ ಲೈಬ್ರರಿ ಎಲ್ಲವನ್ನೂ ನಿರ್ವಹಿಸುತ್ತದೆ.
package main import ( "encoding/json" "fmt" "net/http" "io" ) func main() { // USD inflation — no-key evaluation, up to 100 requests/day resp, err := http.Get("https://api.fxmacrodata.com/v1/announcements/usd/inflation") if err != nil { panic(err) } defer resp.Body.Close() body, _ := io.ReadAll(resp.Body) var result map[string]interface{} json.Unmarshal(body, &result;) fmt.Println(result) }
R
ಅಗತ್ಯವಿದೆ httr ಮತ್ತು jsonlite.
library(httr) library(jsonlite) # USD inflation — no-key evaluation, up to 100 requests/day res <- GET("https://api.fxmacrodata.com/v1/announcements/usd/inflation") data <- fromJSON(content(res, "text", encoding = "UTF-8")) # Convert to data frame df <- as.data.frame(data$data) head(df) # With API key for non-USD eur <- GET( "https://api.fxmacrodata.com/v1/announcements/eur/policy_rate", add_headers(`X-API-Key` = "YOUR_API_KEY") ) print(fromJSON(content(eur, "text")))
Java
ಬಳಕೆಗಳು java.net.http (Java 11+). ಯಾವುದೇ ಬಾಹ್ಯ ಲೈಬ್ರರಿಗಳ ಅಗತ್ಯವಿಲ್ಲ.
import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class FXMacroDataExample { public static void main(String[] args) throws Exception { var client = HttpClient.newHttpClient(); var request = HttpRequest.newBuilder() .uri(URI.create("https://api.fxmacrodata.com/v1/announcements/usd/inflation")) .build(); var response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }
C# / .NET
ಬಳಕೆಗಳು HttpClient (.NET 6+).
using System.Net.Http; using System.Text.Json; var client = new HttpClient(); // USD inflation — no-key evaluation, up to 100 requests/day var json = await client.GetStringAsync( "https://api.fxmacrodata.com/v1/announcements/usd/inflation" ); var doc = JsonDocument.Parse(json); Console.WriteLine(doc.RootElement);
MATLAB
ಬಿಲ್ಟ್-ಇನ್ ಬಳಸಿ webread ಕಾರ್ಯ.
% USD inflation — no-key evaluation, up to 100 requests/day data = webread('https://api.fxmacrodata.com/v1/announcements/usd/inflation'); disp(data); % With API key for non-USD opts = weboptions('Timeout', 30, 'HeaderFields', {'X-API-Key', 'YOUR_API_KEY'}); url = 'https://api.fxmacrodata.com/v1/announcements/eur/policy_rate'; eur = webread(url, opts); disp(eur);
ಯಾವುದೇ ಭಾಷೆಗೆ ಟೈಪ್ಡ್ ಕ್ಲೈಂಟ್ ಅನ್ನು ಜನರೇಟ್ ಮಾಡಿ
FXMacroData API ಒಂದು ಸಂಪೂರ್ಣವನ್ನು ಪ್ರಕಟಿಸುತ್ತದೆ OpenAPI 3.1 ಸ್ಪೆಸಿಫಿಕೇಶನ್. ಇದನ್ನು ಇದರೊಂದಿಗೆ ಬಳಸಿ openapi-generator Kotlin, Swift, Rust, Dart, Ruby, PHP, ಮತ್ತು 40+ ಇತರ ಭಾಷೆಗಳಿಗೆ ಸಂಪೂರ್ಣವಾಗಿ ಟೈಪ್ ಮಾಡಲಾದ ಕ್ಲೈಂಟ್ಗಳನ್ನು ತಯಾರಿಸಲು.
# Install the openapi-generator CLI npm install @openapitools/openapi-generator-cli -g # Generate a Go client openapi-generator-cli generate \ -i https://api.fxmacrodata.com/openapi.json \ -g go \ -o ./fxmacrodata-go-client # Generate a Java client openapi-generator-cli generate \ -i https://api.fxmacrodata.com/openapi.json \ -g java \ -o ./fxmacrodata-java-client
ನಿರ್ಮಿಸಲು ಸಿದ್ಧರಿದ್ದೀರಾ?
USD ಬಿಡುಗಡೆ ಡೇಟಾ ಕೀ ಇಲ್ಲದೆಯೇ ಕೆಲಸ ಮಾಡುತ್ತದೆ, ದಿನಕ್ಕೆ 100 ವಿನಂತಿಗಳವರೆಗೆ ಮತ್ತು ಪ್ರಕಟಣೆಯ 15 ನಿಮಿಷಗಳ ಹಿಂದೆ ಇರುತ್ತದೆ. ನೈಜ-ಸಮಯದ ಬಿಡುಗಡೆಗಳು, ಮುನ್ಸೂಚನೆ ಮೌಲ್ಯಗಳು, ಸಂಪೂರ್ಣ ಇತಿಹಾಸ, ಹೆಚ್ಚಿನ ಮಿತಿಗಳು ಮತ್ತು ಪ್ರತಿ ಕರೆನ್ಸಿಗಾಗಿ ಚಂದಾದಾರರಾಗಿ.