ഏത് ഭാഷയിലും തുടങ്ങുക

ഔദ്യോഗികമായി ഇൻസ്റ്റാൾ ചെയ്യുക fxmacrodata PyPI-ൽ നിന്നുള്ള പാക്കേജ്. സിങ്ക് ആൻഡ് അസിങ്ക് ക്ലയന്റുകൾ, pandas-ready ഔട്ട്പുട്ട്.

SDK ഉപയോഗിക്കുന്നു

from fxmacrodata import Client

client = Client(api_key="YOUR_API_KEY")

# USD inflation — no-key evaluation, up to 100 requests/day
data = client.get_indicator("usd", "inflation")

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

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} എൻഡ്‌പോയിന്റ് മാർക്കറ്റ് സമവായ സർവേകൾ, സെൻട്രൽ ബാങ്ക് പ്രൊജക്ഷനുകൾ, IMF വേൾഡ് ഇക്കണോമിക് ഔട്ട്‌ലുക്ക്, പ്രൊഫഷണൽ ഫോർകാസ്റ്റർ സർവേകൾ എന്നിവയിൽ നിന്നുള്ള ഫോർകാസ്റ്റ് ഡാറ്റ നൽകുന്നു. ഒരു പ്രത്യേക കറൻസിക്കും ഇൻഡിക്കേറ്ററിനും വേണ്ടിയുള്ള പ്രവചനങ്ങൾ അഭ്യർത്ഥിക്കുന്നു, ഉദാഹരണത്തിന് https://api.fxmacrodata.com/v1/predictions/usd/inflation; കറൻസി-മാത്രമുള്ള പ്രവചന റിക്വസ്റ്റുകൾ പിന്തുണയ്ക്കുന്നില്ല. ഓരോ പ്രവചനവും അതിന്റെ അറിയിപ്പുമായി ബന്ധിപ്പിച്ചിരിക്കുന്നു announcement_id, അതിനാൽ നിങ്ങൾക്ക് ഫോർകാസ്റ്റുകളെ റിയലൈസ്ഡ് ഒബ്സർവേഷനുകളുമായി യോജിപ്പിക്കാം.

Python — പ്രവചനങ്ങൾ ഫെച്ച് ചെയ്ത് യഥാർത്ഥ മൂല്യങ്ങളുമായി യോജിപ്പിക്കുക

import requests

# Predictions for USD inflation — no-key evaluation, up to 100 requests/day
preds = requests.get(
    "https://api.fxmacrodata.com/v1/predictions/usd/inflation",
    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"},
    timeout=30,
).json()

# Join predictions with actuals using announcement_id
actuals = requests.get(
    "https://api.fxmacrodata.com/v1/announcements/usd/inflation",
    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 — ടൈപ്പ് അനുസരിച്ച് പ്രെഡിക്ഷനുകൾ ഫെച്ച് ചെയ്യുക

# All USD inflation predictions — free
curl "https://api.fxmacrodata.com/v1/predictions/usd/inflation"

# Filter by prediction type: market_consensus, imf_weo, central_bank_forecast, survey
curl "https://api.fxmacrodata.com/v1/predictions/usd/inflation?prediction_type=market_consensus"

# EUR predictions — requires API key
curl "https://api.fxmacrodata.com/v1/predictions/eur/inflation?api_key=YOUR_API_KEY"

# USD policy-rate predictions
curl "https://api.fxmacrodata.com/v1/predictions/usd/policy_rate"

Prediction ടൈപ്പ്സ് റഫറൻസ്

cURL

ഇൻസ്റ്റാൾ ചെയ്യേണ്ടതില്ല. ഏത് ടെർമിനലിൽ നിന്നും പ്രവർത്തിക്കും.

# USD inflation — no-key evaluation, up to 100 requests/day
curl "https://api.fxmacrodata.com/v1/announcements/usd/inflation"

# EUR policy rate — pass your API key as a query parameter
curl "https://api.fxmacrodata.com/v1/announcements/eur/policy_rate?api_key=YOUR_API_KEY"

# Release calendar for Australia
curl "https://api.fxmacrodata.com/v1/calendar/aud?api_key=YOUR_API_KEY"

# 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 "https://api.fxmacrodata.com/v1/forex/usd/jpy?api_key=YOUR_API_KEY"

# Data catalogue (discover available indicators for USD)
curl "https://api.fxmacrodata.com/v1/data_catalogue/usd"

JavaScript / TypeScript

Node.js (18+), Deno, Bun, Fetch API ഉള്ള മോഡേൺ ബ്രൗസറുകളിൽ പ്രവർത്തിക്കുന്നു.

ഔദ്യോഗിക 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 = "YOUR_API_KEY";
const eur = await fetch(
  `https://api.fxmacrodata.com/v1/announcements/eur/policy_rate?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",
  query = list(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 function.

% 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);
url = 'https://api.fxmacrodata.com/v1/announcements/eur/policy_rate?api_key=YOUR_API_KEY';
eur = webread(url, opts);
disp(eur);