کسی بھی زبان میں شروع کریں

مارکیٹ پلیس تک رسائی

FXMacroData سے RapidAPI تک استعمال کریں

RapidAPI FXMacroData REST API کے لیے ایک اختیاری مارکیٹ پلیس چینل ہے۔ FXMacroData ڈیٹا فراہم کرتا ہے؛ RapidAPI آپ کی مارکیٹ پلیس سبسکرپشن، API کی، درخواست کوٹہ اور بلنگ کا انتظام کرتا ہے۔ اس چینل کے ذریعے درخواستوں کے لیے کسی علیحدہ FXMacroData اکاؤنٹ یا کی کی ضرورت نہیں ہے۔

1. کھولیں سرکاری FXMacroData لسٹنگ اور ایک پلان منتخب کریں۔ موجودہ کوریج، کوٹہ اور ریٹ کی حدود کے لیے پرائسنگ ٹیب چیک کریں۔
2. اینڈ پوائنٹ پلے گراؤنڈ سے اپنی RapidAPI کی (key) کاپی کریں اور اسے اپنے سرور ماحول میں اس طرح محفوظ کریں RAPIDAPI_KEY.
3. درخواستیں بھیجیں 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"

اپنی کی (key) کو براؤزر کوڈ اور عوامی ریپوزٹریز سے دور رکھیں۔ طویل نتائج کے سیٹس کے لیے، عمل کریں pagination.next_offset until pagination.has_more غلط ہے۔ اپنی API کی (key) کبھی بھی سپورٹ کو نہ بھیجیں۔

سرکاری انسٹال کریں fxmacrodata PyPI (1.2.x) سے پیکیج۔ سنک (Sync) اور اسنک (async) کلائنٹس سادہ 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")

ایسنک کلائنٹ

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، تاکہ آپ فورکاسٹ کو حقیقت پسندانہ مشاہدات کے ساتھ جوڑ سکیں۔

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"

پیش گوئی کی اقسام کا حوالہ

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);