ເລີ່ມຕົ້ນໃນທຸກພາສາ

ການເຂົ້າເຖິງຕະຫຼາດ

ນຳໃຊ້ FXMacroData ຜ່ານ RapidAPI

RapidAPI ແມ່ນຊ່ອງທາງຕະຫຼາດແບບທາງເລືອກສຳລັບ FXMacroData REST API. FXMacroData ສະໜອງຂໍ້ມູນ; RapidAPI ຄຸ້ມຄອງການສະໝັກສະມາຊິກຕະຫຼາດຂອງທ່ານ, key API, ໂຄຕ້າການຮ້ອງຂໍ ແລະ ການເກັບເງິນ. ບໍ່ຈຳເປັນຕ້ອງມີບັນຊີ FXMacroData ຫຼື key ແຍກຕ່າງຫາກສຳລັບການຮ້ອງຂໍຜ່ານຊ່ອງທາງນີ້.

1. ເປີດ ລາຍການ FXMacroData ຢ່າງເປັນທາງການ ແລະ ເລືອກແຜນການ. ກວດສອບແຖບລາຄາສຳລັບຂອບເຂດການຄຸມ, ໂຄຕ້າ ແລະ ຂີດຈຳກັດອັດຕາການໃຊ້ງານໃນປັດຈຸບັນ.
2. ຄັດລອກ key RapidAPI ຂອງທ່ານຈາກ endpoint playground ແລະ ເກັບໄວ້ໃນ server environment ຂອງທ່ານໃນຮູບແບບ 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). client ແບບ sync ແລະ async ຈະສົ່ງຄືນເປັນພຽງດິຄຊັນນາຣີ JSON ທີ່ສາມາດໂຫຼດເຂົ້າສູ່ pandas ໄດ້ທັນທີ. Client() ໂດຍບໍ່ມີ key ແມ່ນອ່ານລະດັບ free USD; pass 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())

The /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

ບໍ່ຈຳເປັນຕ້ອງຕິດຕັ້ງ. ໃຊ້ງານໄດ້ຈາກ terminal ໃດກໍໄດ້.

# 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

ເຮັດວຽກຝັ່ງ server ໃນ Node.js (18+), Deno, ແລະ Bun. API ບໍ່ໄດ້ສົ່ງ header CORS, ດັ່ງນັ້ນ ໃຫ້ເອີ້ນມັນຈາກ backend ຂອງທ່ານ ແທນທີ່ຈະເອີ້ນຈາກໂຄ້ດຂອງບຣາວເຊີ.

npm client ຢ່າງເປັນທາງການ

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+). ບໍ່ຈຳເປັນຕ້ອງໃຊ້ library ພາຍນອກ.

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