დაიწყეთ ნებისმიერ ენაზე

Marketplace წვდომა

გამოიყენეთ FXMacroData RapidAPI-ის მეშვეობით

RapidAPI არის არჩევითი marketplace არხი FXMacroData REST API-ისთვის. FXMacroData აწვდის მონაცემებს; RapidAPI მართავს თქვენს marketplace გამოწერას, API გასაღებს, მოთხოვნის კვოტას და ბილინგს. ამ არხის მეშვეობით მოთხოვნებისთვის ცალკე FXMacroData ანგარიში ან გასაღები არ არის საჭირო.

1. გახსენით ოფიციალური FXMacroData ჩამონათვალი და აირჩიეთ ტარიფი. შეამოწმეთ ფასების ტაბი მიმდინარე დაფარვის, კვოტებისა და ტარიფის ლიმიტების გასაგებად.
2. დააკოპირეთ თქვენი RapidAPI გასაღები endpoint playground-იდან და შეინახეთ თქვენს სერვერის გარემოში როგორც 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"

შეინახეთ თქვენი გასაღები ბრაუზერის კოდისა და საჯარო რეპოზიტორიებისგან შორს. უფრო გრძელი შედეგების ნაკრებებისთვის, მიჰყევით pagination.next_offset until pagination.has_more არის მცდარი. არასოდეს გაუგზავნოთ თქვენი API გასაღები მხარდაჭერის გუნდს.

დააინსტალირეთ ოფიციალური 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} 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 ჰედერებს, ამიტომ გამოიძახეთ იგი თქვენი ბექენდიდან და არა ბრაუზერის კოდიდან.

ოფიციალური 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);