curl --request GET \
--url https://api.aisa.one/apis/v1/financial/financials \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/financial/financials"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/financial/financials', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/financial/financials",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/financial/financials"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/financial/financials")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/financial/financials")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"financials": {
"income_statements": [
{
"ticker": "<string>",
"report_period": "2023-12-25",
"fiscal_period": "<string>",
"period": "quarterly",
"currency": "<string>",
"accession_number": "<string>",
"form_type": "<string>",
"filing_url": "<string>",
"filing_date": "2023-12-25",
"filing_datetime": "2023-11-07T05:31:56Z",
"revenue": 123,
"cost_of_revenue": 123,
"gross_profit": 123,
"operating_expense": 123,
"selling_general_and_administrative_expenses": 123,
"research_and_development": 123,
"operating_income": 123,
"interest_expense": 123,
"ebit": 123,
"income_tax_expense": 123,
"net_income_discontinued_operations": 123,
"net_income_non_controlling_interests": 123,
"net_income": 123,
"net_income_common_stock": 123,
"preferred_dividends_impact": 123,
"consolidated_income": 123,
"earnings_per_share": 123,
"earnings_per_share_diluted": 123,
"dividends_per_common_share": 123,
"weighted_average_shares": 123,
"weighted_average_shares_diluted": 123
}
],
"balance_sheets": [
{
"ticker": "<string>",
"report_period": "2023-12-25",
"fiscal_period": "<string>",
"period": "quarterly",
"currency": "<string>",
"accession_number": "<string>",
"form_type": "<string>",
"filing_url": "<string>",
"filing_date": "2023-12-25",
"filing_datetime": "2023-11-07T05:31:56Z",
"total_assets": 123,
"current_assets": 123,
"cash_and_equivalents": 123,
"inventory": 123,
"current_investments": 123,
"trade_and_non_trade_receivables": 123,
"non_current_assets": 123,
"property_plant_and_equipment": 123,
"goodwill_and_intangible_assets": 123,
"investments": 123,
"non_current_investments": 123,
"outstanding_shares": 123,
"tax_assets": 123,
"total_liabilities": 123,
"current_liabilities": 123,
"current_debt": 123,
"trade_and_non_trade_payables": 123,
"deferred_revenue": 123,
"deposit_liabilities": 123,
"non_current_liabilities": 123,
"non_current_debt": 123,
"tax_liabilities": 123,
"shareholders_equity": 123,
"retained_earnings": 123,
"accumulated_other_comprehensive_income": 123,
"total_debt": 123
}
],
"cash_flow_statements": [
{
"ticker": "<string>",
"report_period": "2023-12-25",
"fiscal_period": "<string>",
"period": "quarterly",
"currency": "<string>",
"accession_number": "<string>",
"form_type": "<string>",
"filing_url": "<string>",
"filing_date": "2023-12-25",
"filing_datetime": "2023-11-07T05:31:56Z",
"net_income": 123,
"depreciation_and_amortization": 123,
"share_based_compensation": 123,
"net_cash_flow_from_operations": 123,
"capital_expenditure": 123,
"business_acquisitions_and_disposals": 123,
"investment_acquisitions_and_disposals": 123,
"net_cash_flow_from_investing": 123,
"issuance_or_repayment_of_debt_securities": 123,
"issuance_or_purchase_of_equity_shares": 123,
"dividends_and_other_cash_distributions": 123,
"net_cash_flow_from_financing": 123,
"change_in_cash_and_equivalents": 123,
"effect_of_exchange_rate_changes": 123,
"ending_cash_balance": 123,
"free_cash_flow": 123
}
]
},
"next_page_url": "<string>"
}Get Financial Statements
一次调用获取某家公司的全部三张财务报表。
curl --request GET \
--url https://api.aisa.one/apis/v1/financial/financials \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/financial/financials"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/financial/financials', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/financial/financials",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/financial/financials"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/financial/financials")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/financial/financials")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"financials": {
"income_statements": [
{
"ticker": "<string>",
"report_period": "2023-12-25",
"fiscal_period": "<string>",
"period": "quarterly",
"currency": "<string>",
"accession_number": "<string>",
"form_type": "<string>",
"filing_url": "<string>",
"filing_date": "2023-12-25",
"filing_datetime": "2023-11-07T05:31:56Z",
"revenue": 123,
"cost_of_revenue": 123,
"gross_profit": 123,
"operating_expense": 123,
"selling_general_and_administrative_expenses": 123,
"research_and_development": 123,
"operating_income": 123,
"interest_expense": 123,
"ebit": 123,
"income_tax_expense": 123,
"net_income_discontinued_operations": 123,
"net_income_non_controlling_interests": 123,
"net_income": 123,
"net_income_common_stock": 123,
"preferred_dividends_impact": 123,
"consolidated_income": 123,
"earnings_per_share": 123,
"earnings_per_share_diluted": 123,
"dividends_per_common_share": 123,
"weighted_average_shares": 123,
"weighted_average_shares_diluted": 123
}
],
"balance_sheets": [
{
"ticker": "<string>",
"report_period": "2023-12-25",
"fiscal_period": "<string>",
"period": "quarterly",
"currency": "<string>",
"accession_number": "<string>",
"form_type": "<string>",
"filing_url": "<string>",
"filing_date": "2023-12-25",
"filing_datetime": "2023-11-07T05:31:56Z",
"total_assets": 123,
"current_assets": 123,
"cash_and_equivalents": 123,
"inventory": 123,
"current_investments": 123,
"trade_and_non_trade_receivables": 123,
"non_current_assets": 123,
"property_plant_and_equipment": 123,
"goodwill_and_intangible_assets": 123,
"investments": 123,
"non_current_investments": 123,
"outstanding_shares": 123,
"tax_assets": 123,
"total_liabilities": 123,
"current_liabilities": 123,
"current_debt": 123,
"trade_and_non_trade_payables": 123,
"deferred_revenue": 123,
"deposit_liabilities": 123,
"non_current_liabilities": 123,
"non_current_debt": 123,
"tax_liabilities": 123,
"shareholders_equity": 123,
"retained_earnings": 123,
"accumulated_other_comprehensive_income": 123,
"total_debt": 123
}
],
"cash_flow_statements": [
{
"ticker": "<string>",
"report_period": "2023-12-25",
"fiscal_period": "<string>",
"period": "quarterly",
"currency": "<string>",
"accession_number": "<string>",
"form_type": "<string>",
"filing_url": "<string>",
"filing_date": "2023-12-25",
"filing_datetime": "2023-11-07T05:31:56Z",
"net_income": 123,
"depreciation_and_amortization": 123,
"share_based_compensation": 123,
"net_cash_flow_from_operations": 123,
"capital_expenditure": 123,
"business_acquisitions_and_disposals": 123,
"investment_acquisitions_and_disposals": 123,
"net_cash_flow_from_investing": 123,
"issuance_or_repayment_of_debt_securities": 123,
"issuance_or_purchase_of_equity_shares": 123,
"dividends_and_other_cash_distributions": 123,
"net_cash_flow_from_financing": 123,
"change_in_cash_and_equivalents": 123,
"effect_of_exchange_rate_changes": 123,
"ending_cash_balance": 123,
"free_cash_flow": 123
}
]
},
"next_page_url": "<string>"
}financials 对象,内含 income_statements、balance_sheets 和 cash_flow_statements,结构与各自专用接口返回的完全一致。period 为必填(annual、quarterly 或 ttm);用 ticker 或 cik 指定公司,并用 limit 限制条数。当你需要完整全貌、否则就得调用三次时使用它。如果只需要其中一张报表,get_financial_financials_income_statements、get_financial_financials_balance_sheets 或 get_financial_financials_cash_flow_statements 返回的数据量要小得多;如果只需要跨多家公司的少数指定字段,post_financial_financials_search_line_items 范围更窄。
https://mcp.aisa.one/mcp —— Claude Code、
Codex、Cursor、VS Code 都可以。鉴权走 OAuth:客户端打开浏览器,你点一次
Allow,不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见
aisa.one/zh-cn/mcp。费用与请求规则
公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。- 默认请求参考估价(USD): 0.02
- 计费依据: fixed_success
- 公开参考倍率: 1.0
- 结算证据来源: request_snapshot
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
查询参数
公司的中央索引键(CIK)。
Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.
Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded.
Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded.
Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded.
Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded.
Filter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the given date. Rows without a known filing date are excluded.
The maximum number of financial statements to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.
财务报表的时间周期。
annual, quarterly, ttm 按 YYYY-MM-DD 格式的确切报告期日期筛选。
按报告周期筛选,报告周期须晚于 YYYY-MM-DD 格式的日期。
筛选报告期大于或等于 YYYY-MM-DD 格式指定日期的数据。
筛选报告周期早于指定日期的报告,日期格式为 YYYY-MM-DD。
筛选报告期小于或等于 YYYY-MM-DD 格式指定日期的数据。
股票代码。未提供 cik 时必填。