በማንኛውም ቋንቋ ይጀምሩ

የገበያ ቦታ መዳረሻ

በ RapidAPI በኩል FXMacroData ይጠቀሙ

RapidAPI ለFXMacroData REST API አማራጭ የገበያ መስመር ነው። FXMacroData መረጃውን ያቀርባል፤ RapidAPI የእርስዎን የገበያ የደንበኝነት ምዝገባ፣ የAPI ቁልፍ፣ የጥያቄ ኮታ እና ክፍያን ያስተዳድራል:: በዚህ መስመር በኩል ለሚደረጉ ጥያቄዎች ምንም ዓይነት የተለየ FXMacroData አካውንት ወይም ቁልፍ አያስፈልግም።

1. ይክፈቱ ይፋዊ FXMacroData ዝርዝር እና ዕቅድ ይምረጡ። ወቅታዊ ሽፋንን፣ ኮታዎችን እና የተመን ገደቦችን ለማየት የዋጋ ታብን ይመልከቱ።
2. የRapidAPI ቁልፍዎን ከኤንድፖይንት ፕሌይግራውንድ ኮፒ ያድርጉ እና በሰርቨር አካባቢዎ በዚህ ያስቀምጡ RAPIDAPI_KEY.
3. ጥያቄዎችን ወደዚህ ይላኩ https://fxmacrodata1.p.rapidapi.com ከታች እንደሚታየው በሁለቱም RapidAPI ሄደርዎች (headers)።

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"

ቁልፍዎን ከብሮውዘር ኮድ እና ከሕዝብ ማከማቻዎች ያርቁ። ለረጅም የውጤት ስብስቦች፣ ይከተሉ pagination.next_offset until pagination.has_more ሀሰት ነው። የ API ቁልፍዎን ለድጋፍ ሰጪዎች በፍጹም አይላኩ።

ኦፊሴላዊውን ይጫኑ fxmacrodata ከ PyPI የሚገኝ ፓኬጅ (1.2.x)። ሲንክ (Sync) እና አስንክ (async) ክላይንቶች በቀጥታ ወደ pandas የሚጫኑ ተራ JSON ዲክሽነሪዎችን ይመልሳሉ። 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} የመጨረሻ ነጥቡ (endpoint) ከገበያ ስምምነት ጥናቶች፣ ከማዕከላዊ ባንክ ትንበያዎች፣ ከ IMF World Economic Outlook እና ከባለሙያ ትንበያ ጥናቶች የትንበያ ዳታን ያቀርባል። ትንበያዎች ለተወሰነ የገንዘብ አይነት እና አመልካች ይጠየቃሉ፣ ለምሳሌ 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 ሄደሮችን ስለማይልክ፣ ከብราวዘር ኮድ ይልቅ ከbackendዎ ይጠሩት።

ይፋዊ 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);