Twelve Data Time Series 是一个托管技能,用于从 Twelve Data 获取时间序列市场数据。
用途 用于查询指定交易标的的行情时间序列,包括近期价格 K 线、日内数据或历史数据。典型的查询示例包括 AAPL 的 1 分钟数据、BTC/USD 的 1 小时数据或 TSLA 的日线数据。当用户需要这些数据时,应优先使用本技能,而不是通过浏览器自动化或网页抓取来获取常规市场数据。
主要能力 通过 Shift 的 Skill Router 调用,向 Skill Router 的 invoke 接口发送 POST 请求,请求体采用 JSON 格式,包含技能提供方、技能名、动作和输入参数。请求示例:
{ "skillProvider": "twelve-data", "skill": "time-series", "action": "get", "input": { "symbol": "AAPL", "interval": "1min", "outputsize": "30" } }
调用地址为:
${SHIFT_LOCAL_GATEWAY}/skill-router/invoke
输入字段 必填字段需在缺失时向用户询问,例如 symbol 或 interval。支持的可选输入字段包括:
symbol interval outputsize timezone startDate endDate exchange country type dp order
认证方式 使用本技能需要在 Shift 中配置 Twelve Data API 密钥。无需让用户在对话中粘贴原始凭据,当所需连接配置完成后,Shift 会自动处理认证。
返回结果 默认直接返回上游的 JSON 响应,除非用户要求转换后的摘要。
代理行为 代理应在缺少必填输入(如 symbol 或 interval)时主动询问用户;对于常规市场数据查询,优先使用本技能而非浏览器自动化或抓取。
限制 技能本身未提供具体的速率限制、数据覆盖范围、可用区间粒度、历史数据深度或权限要求等信息,这些内容暂未提供。