> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # News Sentiment > 按用量计费；默认请求预估费用：$0.00036 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 ## 请求规范 * **方法与路径:** POST /apis/v1/alpha-vantage/news-sentiment * **可用状态:** enabled * **请求 URL 模板:** `https://api.aisa.one/apis/v1/alpha-vantage/news-sentiment` * **Runtime 事实版本:** 1036de6c0ab36754ec1c89b501ce10968b8978d428608ec2aa1b69562af101bb [完整 OpenAPI 定义](https://aisa.one/docs/reference-contracts/zh/alpha-vantage.json) 有效请求与价格声明（包括认证和引用的 schema）： ```json theme={null} { "operationId": "alpha-vantage.news-sentiment", "method": "POST", "path": "/apis/v1/alpha-vantage/news-sentiment", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "sort": { "enum": [ "LATEST", "EARLIEST", "RELEVANCE" ], "type": "string", "default": "LATEST", "examples": [ "LATEST", "RELEVANCE" ], "description": "Sort order for articles: 'LATEST', 'EARLIEST', or 'RELEVANCE'." }, "limit": { "type": "integer", "default": 50, "maximum": 1000, "minimum": 1, "examples": [ 50, 100, 1000 ], "description": "Maximum number of articles to return (1-1000). Default is 50. For large result sets, articles may be returned in a remote/attached payload rather than inline — do not assume an inline preview contains all requested articles." }, "topics": { "type": "array", "items": { "enum": [ "blockchain", "earnings", "ipo", "mergers_and_acquisitions", "financial_markets", "economy_fiscal", "economy_monetary", "economy_macro", "energy_transportation", "finance", "life_sciences", "manufacturing", "real_estate", "retail_wholesale", "technology" ], "type": "string" }, "description": "List of topics to filter articles, e.g. ['technology','ipo']. Supported values are the topic literals." }, "tickers": { "type": "string", "examples": [ "AAPL", "COIN,CRYPTO:BTC,FOREX:USD" ], "description": "Comma-separated tickers or asset identifiers to filter articles. Each ticker can only contain alphanumeric characters, colons, and underscores. Examples: 'AAPL', 'CRYPTO:BTC', 'FOREX:USD', 'AAPL,CRYPTO:BTC,FOREX:USD'." }, "time_to": { "type": "string", "description": "End of time range (inclusive) in YYYYMMDDTHHMM format. If omitted, defaults to current time." }, "time_from": { "type": "string", "examples": [ "20220410T0130" ], "description": "Start of time range (inclusive) in YYYYMMDDTHHMM format, e.g. '20220410T0130'." } } } } } }, "x-aisa-status": "enabled", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.00036, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 10000000, "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## 费用与请求规则 按用量计费；默认请求预估费用：\$0.00036 USD（不是固定价格）。 声明的单位费率：每 provider\_credit \$0.000001 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。 * **默认请求参考估价（USD）:** 0.00036 * **声明的单位费率（USD）:** 1e-06 * **计费单位:** provider\_credit * **计费依据:** response\_units * **公开参考倍率:** 1.0 * **声明的最大计数或单位数:** 10000000 * **结算证据来源:** response\_body ## OpenAPI ````yaml reference-contracts/zh/alpha-vantage.json POST /apis/v1/alpha-vantage/news-sentiment openapi: 3.1.0 info: description: '' title: Alpha Vantage version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/alpha-vantage/company-overview - /apis/v1/alpha-vantage/crypto-intraday - /apis/v1/alpha-vantage/currency-exchange-rate - /apis/v1/alpha-vantage/fx-daily - /apis/v1/alpha-vantage/fx-intraday - /apis/v1/alpha-vantage/global-quote - /apis/v1/alpha-vantage/market-status - /apis/v1/alpha-vantage/news-sentiment - /apis/v1/alpha-vantage/symbol-search - /apis/v1/alpha-vantage/time-series-daily - /apis/v1/alpha-vantage/time-series-intraday - /apis/v1/alpha-vantage/top-gainers-losers x-aisa-document: facts_hash: 1036de6c0ab36754ec1c89b501ce10968b8978d428608ec2aa1b69562af101bb generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '28' response_pending: [] document_hash: sha256:8fa01711b98a12ada8aed2dcd794b235bf897e01f7b1416e24fc1a4ca21fab3d x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: alpha-vantage x-aisa-catalogs: alpha-vantage: title: Alpha Vantage description: '' x-aisa-document: facts_hash: 1036de6c0ab36754ec1c89b501ce10968b8978d428608ec2aa1b69562af101bb generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/alpha-vantage/news-sentiment: post: tags: - Alpha Vantage summary: News Sentiment description: >- 按用量计费；默认请求预估费用：$0.00036 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 operationId: alpha-vantage.news-sentiment requestBody: required: false content: application/json: schema: type: object properties: sort: enum: - LATEST - EARLIEST - RELEVANCE type: string default: LATEST examples: - LATEST - RELEVANCE description: >- Sort order for articles: 'LATEST', 'EARLIEST', or 'RELEVANCE'. limit: type: integer default: 50 maximum: 1000 minimum: 1 examples: - 50 - 100 - 1000 description: >- Maximum number of articles to return (1-1000). Default is 50. For large result sets, articles may be returned in a remote/attached payload rather than inline — do not assume an inline preview contains all requested articles. topics: type: array items: enum: - blockchain - earnings - ipo - mergers_and_acquisitions - financial_markets - economy_fiscal - economy_monetary - economy_macro - energy_transportation - finance - life_sciences - manufacturing - real_estate - retail_wholesale - technology type: string description: >- List of topics to filter articles, e.g. ['technology','ipo']. Supported values are the topic literals. tickers: type: string examples: - AAPL - COIN,CRYPTO:BTC,FOREX:USD description: >- Comma-separated tickers or asset identifiers to filter articles. Each ticker can only contain alphanumeric characters, colons, and underscores. Examples: 'AAPL', 'CRYPTO:BTC', 'FOREX:USD', 'AAPL,CRYPTO:BTC,FOREX:USD'. time_to: type: string description: >- End of time range (inclusive) in YYYYMMDDTHHMM format. If omitted, defaults to current time. time_from: type: string examples: - 20220410T0130 description: >- Start of time range (inclusive) in YYYYMMDDTHHMM format, e.g. '20220410T0130'. responses: '200': description: Tool result data content: application/json: schema: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_ALPHA_VANTAGE_NEWS_SENTIMENT__output__public_data default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response576A0Ea506F3_connect_ALPHA_VANTAGE_NEWS_SENTIMENT__output__public_data: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_ALPHA_VANTAGE_NEWS_SENTIMENT__output__4928be2c0d703ec1 Response576A0Ea506F3_connect_ALPHA_VANTAGE_NEWS_SENTIMENT__output__4928be2c0d703ec1: type: object required: - feed properties: feed: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_ALPHA_VANTAGE_NEWS_SENTIMENT__output__985ae463a7e23fc2 items: type: integer next_page: type: string relevance_score_definition: type: string sentiment_score_definition: type: string Response576A0Ea506F3_connect_ALPHA_VANTAGE_NEWS_SENTIMENT__output__985ae463a7e23fc2: type: object required: - title - url - time_published - authors - summary - source - topics - overall_sentiment_score - overall_sentiment_label - ticker_sentiment properties: url: type: string title: type: string source: type: string topics: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_ALPHA_VANTAGE_NEWS_SENTIMENT__output__8c27965b9334a381 authors: type: array items: type: string summary: type: string banner_image: type: string source_domain: type: string time_published: type: string ticker_sentiment: type: array items: $ref: >- #/components/schemas/Response576A0Ea506F3_connect_ALPHA_VANTAGE_NEWS_SENTIMENT__output__2f53898de7afa4a3 category_within_source: type: string overall_sentiment_label: type: string overall_sentiment_score: type: number Response576A0Ea506F3_connect_ALPHA_VANTAGE_NEWS_SENTIMENT__output__8c27965b9334a381: type: object required: - topic - relevance_score properties: topic: type: string relevance_score: type: string Response576A0Ea506F3_connect_ALPHA_VANTAGE_NEWS_SENTIMENT__output__2f53898de7afa4a3: type: object required: - ticker - relevance_score - ticker_sentiment_score - ticker_sentiment_label properties: ticker: type: string relevance_score: type: string ticker_sentiment_label: type: string ticker_sentiment_score: type: string securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.