Quickstart
ਕਿਸੇ ਵੀ ਭਾਸ਼ਾ ਵਿੱਚ ਸ਼ੁਰੂ ਕਰੋ
FXMacroData API ਇੱਕ ਮਿਆਰੀ JSON REST API ਹੈ ਜੋ ਸਰਵਰ-ਸਾਈਡ ਵਰਤੋਂ ਲਈ ਹੈ। ਕੋਈ ਵੀ ਭਾਸ਼ਾ ਜਿਸ ਵਿੱਚ HTTP ਸਹਾਇਤਾ ਹੈ ਉਹ ਕੰਮ ਕਰਦੀ ਹੈ। USD ਘੋਸ਼ਣਾ ਦਾ ਡਾਟਾ, USD ਰੀਲੀਜ਼ ਕੈਲੰਡਰ, ਅਤੇ ਡਾਟਾ ਕੈਟਾਲਾਗ ਮੁਫ਼ਤ ਹਨ ਅਤੇ ਕਿਸੇ ਕੀ (key) ਦੀ ਲੋੜ ਨਹੀਂ ਹੈ: ਸਭ ਤੋਂ ਹਾਲੀਆ 90 ਦਿਨ, 15-ਮਿੰਟ ਦੀ ਰੀਲੀਜ਼ ਦੇਰੀ ਨਾਲ, ਪ੍ਰਤੀ ਦਿਨ 100 ਬੇਨਤੀਆਂ ਤੱਕ। ਪੂਰਵਾਨੁਮਾਨ ਮੁੱਲਯੰਕਣ (USD ਸਮੇਤ), ਹਰ ਦੂਜੀ ਕਰੰਸੀ, ਰੀਅਲ-ਟਾਈਮ ਰੀਲੀਜ਼, ਅਤੇ ਪੂਰੀ ਹਿਸਟਰੀ ਲਈ ਇੱਕ API ਕੀ (key) ਦੀ ਲੋੜ ਹੈ, ਜੋ ਕਿ X-API-Key header. ਦੇਖੋ ਕਿ ਕੀ ਮੁਫ਼ਤ ਹੈ
ਬੇਸ URL
https://api.fxmacrodata.com
ਪ੍ਰਮਾਣਿਕਤਾ
X-API-Key: YOUR_API_KEY
Authorization: Bearer YOUR_API_KEY
ਪੁਰਾਣਾ ?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 ਜਦੋਂ ਤੁਹਾਨੂੰ ਸਿਰਫ ਹਾਲੀਆ ਰੋਅਜ਼ (rows) ਦੀ ਲੋੜ ਹੋਵੇ। ਪੂਰਾ ਹਵਾਲਾ ਦੇਖੋ →
limit 100. ਤੱਕ ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ। ਪੂਰੀ ਰੇਂਜ ਇਕੱਠੀ ਕਰਨ ਲਈ, ਬੇਨਤੀ ਨੂੰ ਦੁਹਰਾਓ offset ਤੇ ਸੈੱਟ ਕਰੋ pagination.next_offset until pagination.has_more is false. ਦੇਖੋ Python ਲੂਪ ↓
fetch() ਵੈੱਬ ਪੇਜ ਤੋਂ ਬਲਾਕ ਕੀਤਾ ਗਿਆ ਹੈ। ਆਪਣੇ ਬੈਕਐਂਡ ਤੋਂ FXMacroData ਨੂੰ ਕਾਲ ਕਰੋ ਅਤੇ API ਕੀ (key) ਨੂੰ ਕਲਾਇੰਟ-ਸਾਈਡ ਕੋਡ ਤੋਂ ਬਾਹਰ ਰੱਖੋ।
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 ਗਲਤ ਹੈ ਜਦੋਂ ਵੀ ਵਿੰਡੋ ਵਿੱਚ ਕੋਈ ਵੀ ਰੋਅ ਸੀਰੀਜ਼ ਦੇ ਮਾਪੇ ਗਏ ਰਿਲੀਜ਼ ਲੈਗ ਤੋਂ ਪ੍ਰਾਪਤ ਪ੍ਰਕਾਸ਼ਨ ਸਮਾਂ ਰੱਖਦਾ ਹੈ, ਇਸ ਲਈ ਜਾਂਚ ਕਰੋ assumed_release_time_count ਅਤੇ ਪ੍ਰਤੀ-ਰੋਅ release_time_assumed ਗਲਤ ਨੂੰ ਵਰਤੋਂ ਅਯੋਗ ਮੰਨਣ ਤੋਂ ਪਹਿਲਾਂ ਫਲੈਗ ਕਰੋ।
ਮਾਰਕੀਟਪਲੇਸ ਪਹੁੰਚ
RapidAPI ਰਾਹੀਂ FXMacroData ਦੀ ਵਰਤੋਂ ਕਰੋ
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, ਭਵਿੱਖਬਾਣੀਆਂ, ਸਟ੍ਰੀਮਿੰਗ ਅਤੇ ਵੈੱਬਹੁਕਸ ਵੱਖਰੀਆਂ ਪੇਸ਼ਕਸ਼ਾਂ ਹਨ।
ਆਪਣੀ ਕੀ ਨੂੰ ਬ੍ਰਾਊਜ਼ਰ ਕੋਡ ਅਤੇ ਜਨਤਕ ਰਿਪੋਜ਼ਟਰੀਆਂ ਤੋਂ ਦੂਰ ਰੱਖੋ। ਲੰਬੇ ਨਤੀਜੇ ਦੇ ਸੈੱਟਾਂ ਲਈ, ਪਾਲਣਾ ਕਰੋ pagination.next_offset until pagination.has_more ਗਲਤ ਹੈ। ਆਪਣੀ API ਚਾਬੀ ਕਦੇ ਵੀ ਸਪੋਰਟ ਨੂੰ ਨਾ ਭੇਜੋ।
ਪਹਿਲੀ API ਕਾਲ
ਕਵਿਕ ਰਿਕੁਐਸਟ
ਪਹਿਲਾ ਸਨਿੱਪੇਟ ਜਿਵੇਂ ਹੈ ਉਵੇਂ ਹੀ ਚਲਦਾ ਹੈ: 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 ਬੇਨਤੀਆਂ
ਇਨ੍ਹਾਂ ਸਿੱਧੇ REST ਉਦਾਹਰਣਾਂ ਦੀ ਵਰਤੋਂ ਕਰੋ ਜਦੋਂ ਤੁਸੀਂ SDK ਰੈਪਰ ਦੀ ਬਜਾਏ ਰਾਅ (raw) API ਰਿਕੁਐਸਟ ਚਾਹੁੰਦੇ ਹੋ। ਸਿਰਫ ਸੁਰੱਖਿਅਤ ਰੂਟਸ 'ਤੇ YOUR_API_KEY ਨੂੰ ਬਦਲੋ।
USD ਮਹਿੰਗਾਈ ਮਾਰਕੀਟ ਸਹਿਮਤੀ
ਕੰਸੈਂਸਸ, ਸਰਵੇਖਣ, ਕੇਂਦਰੀ-ਬੈਂਕ, 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))
ਜਾਣੇ-ਪਛਾਣੇ ਟਾਈਮਸਟੈਂਪਸ ਦੇ ਨਾਲ 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-ਜਨਰੇਟਡ ਅਨੁਮਾਨ ਹੈ; ਇੱਕ ਸੱਚੀ ਸੰਕਲਿਤ ਸਹਿਮਤੀ ਨੂੰ ਲੇਬਲ ਕੀਤਾ ਗਿਆ ਹੈ market_consensus. ਪੂਰਵ ਅਨੁਮਾਨ ਦੀ ਉਪਲਬਧਤਾ ਰਿਲੀਜ਼ ਦੇ ਅਨੁਸਾਰ ਵੱਖ-ਵੱਖ ਹੁੰਦੀ ਹੈ — ਜਾਂਚ ਕਰੋ ਕਵਰੇਜ ਮੈਟ੍ਰਿਕਸ. ਲੁੱਕ-ਅਹੇਡ-ਮੁਕਤ ਖੋਜ ਲਈ, ਇਸਦਾ ਪਾਲਣ ਕਰੋ ਪੁਆਇੰਟ-ਇਨ-ਟਾਈਮ ਬੈਕਟੈਸਟਿੰਗ ਗਾਈਡ.
/v1/predictions/coverage/{currency}. ਇੱਕ ਟਰਾਇਲ ਜਾਂ ਪੇਡ ਕੀ (key) ਪੂਰਵਾਨੁਮਾਨ ਮੁੱਲਯਾਂ ਨੂੰ ਵਾਪਸ ਕਰਦਾ ਹੈ।
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 ਰੀਲੀਜ਼ ਡਾਟਾ ਕਿਸੇ ਕੀ (key) ਤੋਂ ਬਿਨਾਂ ਕੰਮ ਕਰਦਾ ਹੈ, ਪ੍ਰਤੀ ਦਿਨ 100 ਬੇਨਤੀਆਂ ਤੱਕ ਅਤੇ ਪ੍ਰਕਾਸ਼ਨ ਤੋਂ 15 ਮਿੰਟ ਪਿੱਛੇ। ਰੀਅਲ-ਟਾਈਮ ਰੀਲੀਜ਼, ਪੂਰਵਾਨੁਮਾਨ ਮੁੱਲਯੰਕਣ, ਪੂਰੀ ਹਿਸਟਰੀ, ਉੱਚੀਆਂ ਸੀਮਾਵਾਂ, ਅਤੇ ਹਰ ਕਰੰਸੀ ਲਈ ਸਬਸਕ੍ਰਾਈਬ ਕਰੋ।