Bilow luqad kasta

Helitaanka suuqa

Isticmaal FXMacroData iyada oo loo marayo RapidAPI

RapidAPI waa kanaal suuqgeyn oo ikhtiyaari ah oo loogu talagalay FXMacroData REST API. FXMacroData waxay bixisaa xogta; RapidAPI waxay maamushaa is-qoristaada suuqgeynta, furaha API, xaddidnaanta codsiyada iyo biilka. Looma baahna akoon ama furaha FXMacroData oo gooni ah si loo sameeyo codsiyada kanaalkan dhexdiisa.

1. Fur liiska rasmiga ah ee FXMacroData oo dooro qorshe. Fiiri qaybta qiimaynta si aad u ogaato daboolista hadda, xaddidayaasha iyo xaddidayaasha heerka.
2. Ka koobiyeey furahaaga RapidAPI meesha tijaabada endpoint-ka ah, kuna kaydi deegaanka server-kaaga sidii RAPIDAPI_KEY.
3. U dir codsiyada https://fxmacrodata1.p.rapidapi.com iyadoo la isticmaalayo labada madax ee RapidAPI, sida lagu muujiyay hoos.

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"

Ka fogee furahaaga koodhka browser-ka iyo kaydiyeyaasha dadweynaha. Si aad u hesho natiijooyin ka badan, raac pagination.next_offset until pagination.has_more waa been. Weligaa ha u dirin furahaaga API taageerada.

Ku rakib rasmiga ah fxmacrodata xirmo laga helayo PyPI (1.2.x). Macmiilada isku-sync-gareeya iyo kuwa async waxay soo celinayaan qaabab JSON ah oo fudud kuwaas oo si toos ah ugu dhex raranaya pandas. Client() iyadoo aan la isticmaalin furaha waxay akhrinaysaa heerka bilaashka ah ee USD; gudbi api_key ee lacag kasta oo kale iyo keenista xogta ee wakhtiga dhabta ah.

Isticmaalka 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")

Isticmaalka REST API si toos ah

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

Boggaaga oo dhex maraya taariikhda oo dhammaystiran

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

Client-ka 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())

The /v1/predictions/{currency}/{indicator} endpoint-ku wuxuu soo saaraa xogta saadaasha ee sahannada is-afgaradka suuqa, saadaasha bangiga dhexe, IMF World Economic Outlook, iyo sahannada saadaaliyayaasha xirfadleyda ah. Saadaasha waxaa loo codsadaa lacag gaar ah iyo tilmaame, sida https://api.fxmacrodata.com/v1/predictions/usd/inflation; codsiyada saadaalinta ee lacagta kaliya laguma taageero. Saadaalin kasta waxaa lagu xiraa ku dhawaaqisteeda iyada oo loo marayo announcement_id, si aad saadaasha ugu xiri karto indho-indhaynaha la xaqiijiyay.

Python — soo qaado saadaasha oo isku dar xaqiiqada

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 — soo qaado saadaasha iyadoo loo eegayo nooca

# 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"

Tixraaca noocyada saadaasha

cURL

Rakibaad looma baahna. Waxay ka shaqaysaa terminal kasta.

# 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

Wuxuu ka shaqeeyaa dhinaca server-ka Node.js (18+), Deno, iyo Bun. API ma dirto madaxyada CORS, markaa ka wac backend-kaaga halkii aad ka wici lahayd koodhka browser-ka.

Macmiilka rasmiga ah ee 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);

Isticmaalka Fetch si toos ah

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

Tag

Looma baahna xirmooyin dibadda ah — maktabadda caadiga ah ayaa wax walba maamusha.

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

Waxay u baahan tahay httr iyo 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

Isticmaalka java.net.http (Java 11+). Looma baahna maktabado dibadda ah.

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

Isticmaalka 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

Waxay isticmaashaa midka ku dhex jira webread shaqada.

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