FRED
FRED 是圣路易斯联邦储备银行的经济数据服务，汇集了许多国内外机构发布的时间序列，除美国外也有其他国家的序列。通过 ScholarMuse，agent 可以用 find_series 按关键词搜索 FRED，再用 get_series 按 FRED 序列编号取回一条序列的观测值。
对应的 ScholarMuse 工具：find_series、get_series。每次成功调用都会扣积分。
可以这样问你的 agent
你的 agent 会拿到什么
每条记录都带有 id、source、title、url、license、attribution 和 retrievedAt。下面是来自 FRED 的数据字段。
find_series
候选结果来自 FRED 自身的关键词搜索，每次最多 8 条。国家名会保留在查询里，因为 FRED 为每个国家单独设序列。
- seriesId
- 传给 get_series 的编号，如 fred:UNRATE
- title
- FRED 发布的序列标题
- frequency
- 日、周、月、季或年度
- units
- 单位及季节调整方式
- coverageStart
- 首个观测值的日期
- coverageEnd
- 最新观测值的日期
- popularity
- FRED 给出的序列热度分
- rights
- 序列说明提到版权时的提醒
get_series
FRED 序列不返回 geography 字段，地区信息写在标题里。
- seriesId
- 实际取回的序列编号
- title
- 序列标题
- units
- 单位及季节调整方式
- frequency
- 发布频率
- lastUpdated
- FRED 最近一次更新该序列的时间
- rights
- 序列说明提到版权时的提醒
- start
- 返回的首个观测值日期
- end
- 返回的最后一个观测值日期
- count
- 返回的观测值个数
- truncated
- 只返回最近 2000 个点时为 true
- observations
- 日期与数值组成的列表
覆盖范围
- FRED 里的任何序列都可以按编号取回，例如 UNRATE、DGS10，编号不区分大小写。
- 频率以 FRED 发布的为准，从日度市场利率到年度数据都有。
- 搜索用的是 FRED 自己的全文检索，查询里可以写国家、概念或发布名称。
限制
- get_series 每次只取一条序列，最多返回最近的 2000 个观测值。较长的日度序列请指定 start 和 end。
- FRED 没有国家参数。每个国家有各自的序列编号，搜索时请把国家写进查询。
- 只调用序列搜索、序列元数据和观测值三类接口，不提供发布日历、分类浏览和序列的历史修订版本。
- 缺失值会被去掉；部分序列的版权属于原始提供方，复用前请看 rights 字段。
ScholarMuse 怎么访问 FRED
连接器直接调用 FRED API：find_series 走 series/search，get_series 走 series 和 series/observations。FRED 每个请求都要带 API key，ScholarMuse 使用自己的 key；没有这个 key 时，两个工具里的 FRED 部分都会报错。
观测值最多缓存 1 小时，搜索结果缓存 12 小时，序列标题和单位缓存 1 天。
API key：上游 API 需要 key，ScholarMuse 用自己的 key，你不用申请。
许可与署名
许可：FRED API Terms of Use (some series are copyrighted by their original providers)
Source: FRED, Federal Reserve Bank of St. Louis (fred.stlouisfed.org). This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis.
来自 FRED 的记录都带这段许可和署名。 在论文里引用时，请按 FRED 自己的引用要求来写。
