REST API 레퍼런스

curl -s https://api.fundafx.link/api/v1/auth/usage \
  -H "X-API-Key: YOUR_KEY"

{
  "api_key_id": 1,                  // API 키의 내부 ID
  "requests_this_month": 0,         // 이번 달 요청 수
  "rate_limit_per_month": 100,      // 월간 상한 (Free: 100, Pro: 5000)
  "tier": "free"                    // 등급: "free" 또는 "pro"
}

curl -s "https://api.fundafx.link/api/v1/facts?currency=USD&importance=high&limit=5&date_from=2026-03-15T00:00:00Z" \
  -H "X-API-Key: YOUR_KEY"

{
  "items": [
    {
      "id": "6615a7ca-b2df-47c8-b038-c08bf260505a",
      "fact_type": "media_report",
      "category": "geopolitical",
      "importance": "high",
      "stage": "published",
      "text": {
        "en": {
          "title": "Global markets to stay driven by West Asia conflict; Fed neutral guidance reflects uncertainty",
          "summary": "The Afghanistannews.net report states that global markets will remain driven by the West Asia conflict, and that Federal Reserve neutral guidance reflects uncertainty.",
          "detail": null,
          "quality_score": null
        },
        "ja": {
          "title": "西アジア情勢が世界市場を引き続き動かす；FRBの中立的指針は不確実性を反映",
          "summary": "アフガニスタンニュースの報道によれば、西アジア情勢が世界市場を引き続き動かし、連邦準備制度の中立的なガイダンスが不確実性を反映している。",
          "detail": null,
          "quality_score": null
        }
      },
      "currencies_affected": [
        { "code": "USD" }
      ],
      "context": {
        "related_facts": [
          {
            "id": "2f9c4bd9-7e5f-4243-b97e-9253b0fe31b6",
            "title": "Bureau of Labor Statistics posted about employment data on X",
            "fact_type": "institutional_release",
            "event_timestamp": "2026-03-20T14:08:02+00:00"
          }
        ],
        "currency_context": {
          "USD": {
            "dominant_category": "gdp_growth",
            "recent_fact_count": 32
          }
        }
      },
      "verification_details": {
        "sources_checked": 2,
        "sources_confirmed": 1,
        "confidence_score": 0.662,
        "verified_at": "2026-03-21T05:30:36.860963",
        "notes": "Rule check: No numeric value to rule-check; deferring to LLM..."
      },
      "source_urls": ["http://www.afghanistannews.net/news/278934978/..."],
      "source_name": "gdelt",
      "source_collector": "gdelt",
      "event_timestamp": "2026-03-21T04:15:00+00:00",
      "created_at": "2026-03-20T20:30:42.740844+00:00",
      "updated_at": "2026-03-20T20:30:42.740844+00:00",
      "published_at": "2026-03-20T20:30:42.740844+00:00"
    }
  ],
  "count": 35,
  "limit": 5,
  "offset": 0,
  "disclaimer": {
    "en": "This information is AI-aggregated factual data and does not constitute investment advice. Past statistics do not guarantee future results. All investment decisions are made at your own risk and responsibility.",
    "ja": "本情報はAIによる事実情報の収集・構造化データであり、投資助言ではありません。過去の統計は将来の結果を保証するものではなく、最終的な投資判断は必ずご自身の責任で行ってください。"
  }
}

curl -s "https://api.fundafx.link/api/v1/facts/6615a7ca-b2df-47c8-b038-c08bf260505a" \
  -H "X-API-Key: YOUR_KEY"

curl -s "https://api.fundafx.link/api/v1/indicators?country_code=US" \
  -H "X-API-Key: YOUR_KEY"

{
  "items": [
    {
      "id": 2,
      "code": "US_CPI",
      "name_en": "US Consumer Price Index",
      "name_ja": "米国消費者物価指数",
      "country_code": "US",
      "currency": "USD",
      "category": "inflation",
      "importance": "high",
      "unit": "Index",
      "frequency": "monthly",
      "source_api": "OECD",
      "source_series_id": "CPIAUCSL",
      "description": null
    },
    {
      "id": 1,
      "code": "US_GDP",
      "name_en": "US Gross Domestic Product",
      "name_ja": "米国GDP",
      "country_code": "US",
      "currency": "USD",
      "category": "gdp_growth",
      "importance": "high",
      "unit": "Billions USD",
      "frequency": "quarterly",
      "source_api": "OECD",
      "source_series_id": "GDP",
      "description": null
    },
    {
      "id": 3,
      "code": "US_NFP",
      "name_en": "US Nonfarm Payrolls",
      "name_ja": "米国非農業部門雇用者数",
      "country_code": "US",
      "currency": "USD",
      "category": "employment",
      "importance": "high",
      "unit": "Thousands",
      "frequency": "monthly",
      "source_api": "OECD",
      "source_series_id": "PAYEMS",
      "description": null
    }
  ],
  "count": 6,
  "disclaimer": { "en": "...", "ja": "..." }
}

curl -s "https://api.fundafx.link/api/v1/indicators/1" \
  -H "X-API-Key: YOUR_KEY"

{
  "id": 1,
  "code": "US_GDP",
  "name_en": "US Gross Domestic Product",
  "name_ja": "米国GDP",
  "country_code": "US",
  "currency": "USD",
  "category": "gdp_growth",
  "importance": "high",
  "unit": "Billions USD",
  "frequency": "quarterly",
  "source_api": "OECD",
  "source_series_id": "GDP",
  "description": null,
  "values": []  // 시계열 데이터 (value, previous_value, expected_value, period, release_date)
}

curl -s "https://api.fundafx.link/api/v1/central-banks" \
  -H "X-API-Key: YOUR_KEY"

{
  "items": [
    {
      "id": 1,
      "code": "FED",
      "name_en": "Federal Reserve",
      "name_ja": "米連邦準備制度理事会",
      "country_code": "US",
      "currency": "USD",
      "institution_type": "central_bank",
      "website_url": "https://www.federalreserve.gov",
      "current_rate": 4.5,
      "next_meeting_date": "2026-03-18",
      "governor_name": "Jerome Powell",
      "is_active": true,
      "metadata": {}
    },
    {
      "id": 2,
      "code": "ECB",
      "name_en": "European Central Bank",
      "name_ja": "欧州中央銀行",
      "country_code": "EU",
      "currency": "EUR",
      "current_rate": 3.15,
      "next_meeting_date": "2026-03-06",
      "governor_name": "Christine Lagarde"
    },
    { "code": "BOJ", "name_ja": "日本銀行", "current_rate": 0.5, "governor_name": "Kazuo Ueda" },
    { "code": "BOE", "name_ja": "イングランド銀行", "current_rate": 4.5, "governor_name": "Andrew Bailey" },
    { "code": "RBA", "name_ja": "オーストラリア準備銀行", "current_rate": 4.1, "governor_name": "Michele Bullock" },
    { "code": "BOC", "name_ja": "カナダ銀行", "current_rate": 3.25, "governor_name": "Tiff Macklem" },
    { "code": "SNB", "name_ja": "スイス国立銀行", "current_rate": 0.5, "governor_name": "Martin Schlegel" },
    { "code": "RBNZ", "name_ja": "ニュージーランド準備銀行", "current_rate": 3.75, "governor_name": "Adrian Orr" }
  ],
  "count": 8
}

{
  "institutions": [
    { "code": "FED", "currency": "USD", "current_rate": 4.5 },
    { "code": "ECB", "currency": "EUR", "current_rate": 3.15 },
    { "code": "BOJ", "currency": "JPY", "current_rate": 0.5 }
  ],
  "matrix": {
    "FED": { "ECB": 1.35, "BOJ": 4.0, "BOE": 0.0, "RBA": 0.4 },  // FED 금리 - 상대 금리
    "ECB": { "FED": -1.35, "BOJ": 2.65, "BOE": -1.35 },
    "BOJ": { "FED": -4.0, "ECB": -2.65, "BOE": -4.0 }
  }
}

curl -s "https://api.fundafx.link/api/v1/central-banks/FED" \
  -H "X-API-Key: YOUR_KEY"

{
  "id": 1,
  "code": "FED",
  "name_en": "Federal Reserve",
  "name_ja": "米連邦準備制度理事会",
  "country_code": "US",
  "currency": "USD",
  "institution_type": "central_bank",
  "website_url": "https://www.federalreserve.gov",
  "current_rate": 4.5,                    // 현재 정책금리 (%)
  "next_meeting_date": "2026-03-18",       // 다음 회의일
  "governor_name": "Jerome Powell",        // 총재 이름
  "is_active": true,
  "metadata": {}
}

curl -s "https://api.fundafx.link/api/v1/exchange-rates/EURUSD?days=3" \
  -H "X-API-Key: YOUR_KEY"

{
  "pair": "EURUSD",
  "base_currency": "EUR",
  "quote_currency": "USD",
  "values": [
    { "date": "2026-03-19", "close": 1.1489 },
    { "date": "2026-03-18", "close": 1.15 },
    { "date": "2026-03-17", "close": 1.1531 }
  ],
  "count": 3,
  "disclaimer": {
    "en": "This information is AI-aggregated factual data...",
    "ja": "本情報はAIによる事実情報の収集・構造化データであり..."
  }
}

curl -s "https://api.fundafx.link/api/v1/sources" \
  -H "X-API-Key: YOUR_KEY"

{
  "data_sources": [
    {
      "name": "ecb",
      "display_name_en": "ECB Statistical Data",
      "display_name_ja": "ECB統計データ",
      "category": "central_bank",
      "is_active": true,
      "license": "Free use with attribution (Source: ECB statistics.)",
      "url": "https://data.ecb.europa.eu"
    },
    {
      "name": "estat",
      "display_name_en": "e-Stat (Japan Statistics)",
      "display_name_ja": "e-Stat（政府統計）",
      "category": "government",
      "is_active": true,
      "license": "CC-BY 4.0",
      "url": "https://www.e-stat.go.jp"
    }
  ],
  "monitoring_accounts": [
    { "username": "FederalReserve", "display_name": "Federal Reserve" }
  ]
}