MacroPulse

{
  "properties": {
    "event": {
      "description": "Economic event identifier",
      "enum": [
        "NFP",
        "CPI",
        "FOMC",
        "GDP",
        "PPI",
        "PCE",
        "ISM",
        "JOLTS",
        "RETAIL_SALES",
        "UNEMPLOYMENT",
        "ECB",
        "BOJ",
        "BOE",
        "RBA",
        "RBNZ",
        "BOC"
      ],
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "event"
  ],
  "type": "object"
}

{
  "properties": {
    "amount": {
      "default": 1,
      "description": "Amount to convert. Default 1 (the raw rate).",
      "required": false,
      "type": "number",
      "x-parameter-location": "query"
    },
    "date": {
      "description": "YYYY-MM-DD. Returns that day's ECB fixing, or the last fixing on or before it (whose date is reported back in `date`, with is_last_available_fixing=true). Omit for the latest.",
      "example": "2024-03-15",
      "format": "date",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "from": {
      "description": "Source currency, ISO 4217 alpha-3.",
      "example": "USD",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    },
    "to": {
      "description": "Target currency, or a comma-separated list (max 30).",
      "example": "EUR,GBP",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "from",
    "to"
  ],
  "type": "object"
}

{
  "properties": {
    "amount_in": {
      "type": "number"
    },
    "cache_hint_seconds": {
      "type": "integer"
    },
    "date": {
      "description": "The ECB fixing date actually used.",
      "type": "string"
    },
    "deterministic": {
      "type": "boolean"
    },
    "from": {
      "type": "string"
    },
    "is_last_available_fixing": {
      "type": "boolean"
    },
    "requested_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "source": {
      "type": "string"
    },
    "to": {
      "additionalProperties": {
        "properties": {
          "amount": {
            "type": "number"
          },
          "rate": {
            "type": "number"
          }
        },
        "type": "object"
      },
      "type": "object"
    }
  },
  "type": "object"
}

{
  "amount_in": 1,
  "cache_hint_seconds": 1,
  "date": "test",
  "deterministic": true,
  "from": "test",
  "is_last_available_fixing": true,
  "requested_date": "test",
  "source": "test",
  "to": {}
}

{
  "properties": {
    "series": {
      "description": "Up to 5 comma-separated BLS series ids or aliases",
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "series"
  ],
  "type": "object"
}

{
  "properties": {
    "series": {
      "description": "Optional comma-separated filter. Any of: gdp_level, gdp_change, pce_level, pce_change, rfs_level, rfs_change, sofr. Omit for all seven.",
      "example": "gdp_change,sofr",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [],
  "type": "object"
}

{
  "properties": {
    "deterministic": {
      "type": "boolean"
    },
    "series": {
      "items": {
        "properties": {
          "as_of": {
            "description": "The round's updatedAt",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "chain": {
            "enum": [
              "eip155:8453",
              "eip155:1"
            ],
            "type": "string"
          },
          "contract": {
            "type": "string"
          },
          "error": {
            "type": [
              "string",
              "null"
            ]
          },
          "key": {
            "enum": [
              "gdp_level",
              "gdp_change",
              "pce_level",
              "pce_change",
              "rfs_level",
              "rfs_change",
              "sofr"
            ],
            "type": "string"
          },
          "name": {
            "description": "The contract's own description()",
            "type": "string"
          },
          "publisher": {
            "type": "string"
          },
          "round_id": {
            "description": "Packed uint80: phase << 64 | aggregatorRoundId",
            "type": [
              "string",
              "null"
            ]
          },
          "stale": {
            "description": "True when served from cache after a live read failed",
            "type": "boolean"
          },
          "units": {
            "type": "string"
          },
          "value": {
            "description": "Scaled by the contract's own decimals(). NULL - never 0 - if the feed could not be read.",
            "type": [
              "number",
              "null"
            ]
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "source": {
      "description": "Publishers, transport, chains, license, verifiable",
      "type": "object"
    },
    "verify": {
      "description": "Contract addresses and selectors so you can check every value yourself",
      "type": "object"
    }
  },
  "type": "object"
}

{
  "deterministic": true,
  "series": [
    {
      "as_of": "2026-07-23T12:00:00Z",
      "chain": "eip155:8453",
      "contract": "test",
      "error": "test",
      "key": "gdp_level",
      "name": "test",
      "publisher": "test",
      "round_id": "test",
      "stale": true,
      "units": "test",
      "value": "test"
    }
  ],
  "source": {},
  "verify": {}
}

{
  "properties": {
    "limit": {
      "default": 8,
      "description": "How many prints to walk back. Default 8, max 24.",
      "maximum": 24,
      "minimum": 1,
      "required": false,
      "type": "integer",
      "x-parameter-location": "query"
    },
    "series": {
      "default": "gdp_change",
      "description": "Which series to trace. Default gdp_change.",
      "enum": [
        "gdp_level",
        "gdp_change",
        "pce_level",
        "pce_change",
        "rfs_level",
        "rfs_change",
        "sofr"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [],
  "type": "object"
}

{
  "properties": {
    "deterministic": {
      "type": "boolean"
    },
    "errors": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "history_method": {
      "description": "phases_walked, complete_history, phase_overlap_deduped, cross_phase_walk",
      "type": "object"
    },
    "key": {
      "enum": [
        "gdp_level",
        "gdp_change",
        "pce_level",
        "pce_change",
        "rfs_level",
        "rfs_change",
        "sofr"
      ],
      "type": "string"
    },
    "latest_vs_first": {
      "type": [
        "object",
        "null"
      ]
    },
    "name": {
      "type": "string"
    },
    "prints": {
      "items": {
        "properties": {
          "as_of": {
            "format": "date-time",
            "type": "string"
          },
          "phase": {
            "type": "integer"
          },
          "revision_from_previous": {
            "description": "Change from the next older print. Computed in integer space, so 2.1 - 1.6 is exactly 0.5.",
            "type": [
              "number",
              "null"
            ]
          },
          "round_id": {
            "type": "string"
          },
          "value": {
            "type": "number"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "trail_is_reliable": {
      "description": "False if any round could not be read. A short trail from throttling must never be read as \"never revised\".",
      "type": "boolean"
    },
    "trail_semantics": {
      "description": "BEA quarterly series are genuine revisions of one estimate. SOFR rounds are simply the next day's rate, so they are labelled daily_prints rather than dressed up as revisions.",
      "enum": [
        "revisions",
        "daily_prints"
      ],
      "type": "string"
    },
    "verify": {
      "type": "object"
    }
  },
  "type": "object"
}

{
  "deterministic": true,
  "errors": [
    "test"
  ],
  "history_method": {},
  "key": "gdp_level",
  "latest_vs_first": "test",
  "name": "test",
  "prints": [
    {
      "as_of": "2026-07-23T12:00:00Z",
      "phase": 1,
      "revision_from_previous": "test",
      "round_id": "test",
      "value": 1
    }
  ],
  "trail_is_reliable": true,
  "trail_semantics": "revisions",
  "verify": {}
}

{
  "properties": {
    "at": {
      "description": "ISO 8601 timestamp to evaluate. Default: now.",
      "example": "2026-12-25T14:30:00Z",
      "format": "date-time",
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    },
    "exchange": {
      "description": "Exchange code. Aliases accepted (TSE->JPX, XNYS->NYSE, FRANKFURT->XETRA, ...).",
      "enum": [
        "NYSE",
        "NASDAQ",
        "LSE",
        "XETRA",
        "EURONEXT",
        "SIX",
        "JPX",
        "HKEX",
        "SSE",
        "ASX",
        "TSX",
        "NSE",
        "BSE"
      ],
      "required": true,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [
    "exchange"
  ],
  "type": "object"
}

{
  "properties": {
    "at": {
      "type": "string"
    },
    "calendar_coverage_until": {
      "type": "string"
    },
    "deterministic": {
      "type": "boolean"
    },
    "exchange": {
      "type": "string"
    },
    "holiday": {
      "properties": {
        "date": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "type": [
        "object",
        "null"
      ]
    },
    "is_open": {
      "type": "boolean"
    },
    "local_time": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "next_close": {
      "type": [
        "string",
        "null"
      ]
    },
    "next_open": {
      "type": [
        "string",
        "null"
      ]
    },
    "session": {
      "properties": {
        "close": {
          "type": "string"
        },
        "half_day": {
          "type": "boolean"
        },
        "lunch_break": {
          "type": "boolean"
        },
        "open": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "status": {
      "enum": [
        "open",
        "pre_market",
        "after_hours",
        "lunch_break",
        "closed_weekend",
        "closed_holiday"
      ],
      "type": "string"
    },
    "timezone": {
      "type": "string"
    }
  },
  "type": "object"
}

{
  "at": "test",
  "calendar_coverage_until": "test",
  "deterministic": true,
  "exchange": "test",
  "holiday": {
    "date": "test",
    "name": "test"
  },
  "is_open": true,
  "local_time": "test",
  "name": "test",
  "next_close": "test",
  "next_open": "test",
  "session": {
    "close": "test",
    "half_day": true,
    "lunch_break": true,
    "open": "test"
  },
  "status": "open",
  "timezone": "test"
}

{
  "properties": {
    "pair": {
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [],
  "type": "object"
}

{
  "properties": {
    "session": {
      "description": "Trading session. Auto-detected from UTC time if omitted.",
      "enum": [
        "asian",
        "london",
        "newyork"
      ],
      "required": false,
      "type": "string",
      "x-parameter-location": "query"
    }
  },
  "required": [],
  "type": "object"
}

{
  "properties": {
    "agent_action": {
      "type": "string"
    },
    "crypto_context": {
      "type": "string"
    },
    "disclaimer": {
      "type": "string"
    },
    "generated_at": {
      "format": "date-time",
      "type": "string"
    },
    "headline": {
      "type": "string"
    },
    "narrative": {
      "type": "string"
    },
    "rates_snapshot": {
      "type": "object"
    },
    "risk_tone": {
      "enum": [
        "risk-on",
        "risk-off",
        "neutral"
      ],
      "type": "string"
    },
    "scheduled_events": {
      "type": "array"
    },
    "session": {
      "type": "string"
    },
    "top_pairs": {
      "type": "array"
    }
  },
  "type": "object"
}

{
  "agent_action": "test",
  "crypto_context": "test",
  "disclaimer": "test",
  "generated_at": "2026-07-23T12:00:00Z",
  "headline": "test",
  "narrative": "test",
  "rates_snapshot": {},
  "risk_tone": "risk-on",
  "scheduled_events": [],
  "session": "test",
  "top_pairs": []
}