美股公司资料全景 在线试调 →

美股公司资料: 一次拿齐公司画像全部栏目, agent 单轮上下文友好

门槛需要 专业版 及以上

数据公司资料档案全景: 公司信息/财务摘要/营收构成(地区+业务)/分红/拆股/机构评级/内部人变动/大股东变动/板块概念, 随档案日更

限制栏目清单见 section_names; 空栏目自动省略; 响应约15KB

接口说明

美股公司资料全景:公司信息/财务摘要/营收构成/分红/拆股/机构评级/内部人变动/大股东变动/板块概念,一次拿齐。

insider_changes + institution_changes 是资金面信号源

单票深度调研一枪拿齐;只要财务序列用 us_financial 更轻

快速调用

同一调用的三种等价写法,按接入习惯任选其一,复制即可运行。

苹果公司资料全景
import top369 as gp

pro = gp.pro_api("sk-xxxxxxxxxxxx")   # 安装: pip install top369

df = pro.us_f10(code="AAPL")
print(df)

输入参数

名称类型必填描述
codestr必填美股代码: 字母ticker(AAPL), 兼容小写与 .US 后缀(自动归一)
fieldsstr可选挑列: 逗号分隔顶层键(如 fields=sections); 不存在的键被忽略

返回字段

名称类型描述
codestr美股代码(大写ticker)
namestr证券中文名
data_datestr档案日期 YYYY-MM-DD
section_namesdict栏目键→栏目中文名对照
sections.companylist公司信息(名称/行业/国家/业务描述/成立年)
sections.finance_summarylist基础财务近5期(营收/净利/EPS/资产/股本)
sections.dividendslist分红派息(每股股息/除净日)
sections.splitslist拆股合股历史
sections.ratingslist机构评级(机构/评级/日期)
sections.insider_changeslist内部人持股变动(姓名/数量/日期)
sections.blockslist板块概念归属

返回数据样例

{
  "code": "AAPL",
  "name": "苹果",
  "data_date": "2026-11-18",
  "sections": {
    "company": [
      {
        "hy": "电脑与外围设备",
        "gsmc": "苹果公司",
        "code": "AAPL",
        "njr": "09-26",
        "zhy": "电脑硬件、储存设备及电脑周边",
        "szgj": "United States 美国",
        "ywms": "Designs, manufactures smartphones, personal computers, tablets, wearables and accessories",
        "clnf": "1977"
      }
    ],
    "finance_summary": [
      {
        "zzc": "40454800.0000",
        "code": "AAPL",
        "yysr": "47883400.0000",
        "bgq2": "2026年报",
        "EPS": "8.9800",
        "bgq": "2026-09-26",
        "jlr": "13217500.0000",
        "ltgb": "14532182000.00",
        "jzc": "11209300.0000",
        "zgb": "1.4532182E10",
        "bgnd": "2026",
        "bz": "美元",
        "xjl": "37100.0000"
      },
      {
        "zzc": "38326600.0000",
        "code": "AAPL",
        "yysr": "36435700.0000",
        "bgq2": "2026三季报",
        "EPS": "6.8800",
        "bgq": "2026-06-27",
        "jlr": "10146400.0000",
        "ltgb": "14532182000.00",
        "jzc": "10752000.0000",
        "zgb": "1.4532182E10",
        "bgnd": "2026",
        "bz": "美元",
        "xjl": "361000.0000"
      },
      {
        "zzc": "37108200.0000",
        "code": "AAPL",
        "yysr": "25494000.0000",
        "bgq2": "2026中报",
        "EPS": "4.8500",
        "bgq": "2026-03-28",
        "jlr": "7167500.0000",
        "ltgb": "14532182000.00",
        "jzc": "10649100.0000",
        "zgb": "1.4532182E10",
        "bgnd": "2026",
        "bz": "美元",
        "xjl": "963800.0000"
      }
    ],
    "valuation": [
      {
        "code": "AAPL",
        "tbmgsy": "8.9800",
        "sxl": "10.71",
        "syl": "38.79",
        "jll": "27.6035118642",
        "mll": "48.7855916664",
        "sdbl": "70.28219992",
        "zxl": "0.30",
        "zbhbl": "117.9154808953",
        "sjl": "45.74",
        "fzl": "72.2917923213",
        "gxl": "0.30",
        "jyl": "117.9154808953",
        "gxttm": "1.06"
      }
    ],
    "revenue_by_region": [
      {
        "code": "AAPL",
        "xmmc": "美洲",
        "yysr": "198083000000.0000",
        "jzrq": "2026-09-26"
      },
      {
        "code": "AAPL",
        "xmmc": "欧洲",
        "yysr": "127604000000.0000",
        "jzrq": "2026-09-26"
      },
      {
        "code": "AAPL",
        "xmmc": "大中华区",
        "yysr": "82378000000.0000",
        "jzrq": "2026-09-26"
      }
    ],
    "revenue_by_business": [
      {
        "code": "AAPL",
        "xmmc": "苹果手机",
        "yysr": "25409800.0000000000",
        "jzrq": "2026-09-26"
      },
      {
        "code": "AAPL",
        "xmmc": "服务",
        "yysr": "12330100.0000000000",
        "jzrq": "2026-09-26"
      },
      {
        "code": "AAPL",
        "xmmc": "苹果电脑",
        "yysr": "3792900.0000000000",
        "jzrq": "2026-09-26"
      }
    ],
    "dividends": [
      {
        "zfrq": "2026-11-16",
        "code": "AAPL",
        "cqrq": "2026-11-12",
        "djrq": "2026-11-12",
        "mgfh": "0.270000"
      }
    ],
    "splits": [
      {
        "code": "AAPL",
        "cqrq": "2020-08-31",
        "xs": "0.250000",
        "lx": "股票拆分"
      }
    ],
    "ratings": [
      {
        "code": "AAPL",
        "IsHighLight": "0",
        "pjjg": "Loop Capital",
        "pj": "持有",
        "DeclareDate": "20261021"
      },
      {
        "code": "AAPL",
        "IsHighLight": "0",
        "pjjg": "杰富瑞",
        "pj": "低配",
        "DeclareDate": "20260810"
      },
      {
        "code": "AAPL",
        "IsHighLight": "0",
        "pjjg": "杰富瑞",
        "pj": "持有",
        "DeclareDate": "20251031"
      }
    ],
    "insider_changes": [
      {
        "N002": "ADAMS KATHERINE L.",
        "N003": "3750.0000",
        "N004": "20251112",
        "code": "AAPL"
      },
      {
        "N002": "KONDO CHRIS",
        "N003": "3752.0000",
        "N004": "20251107",
        "code": "AAPL"
      },
      {
        "N002": "PAREKH KEVAN",
        "N003": "4199.0000",
        "N004": "20251016",
        "code": "AAPL"
      }
    ],
    "institution_changes": [
      {
        "N002": "State Street SPDR S&P 500 ETF",
        "N003": "-447320.0000",
        "N004": "20261030",
        "code": "AAPL"
      },
      {
        "N002": "Invesco QQQ Trust",
        "N003": "-106418.0000",
        "N004": "20261030",
        "code": "AAPL"
      },
      {
        "N002": "State StreetTechSelSectSPDRETF",
        "N003": "19960.0000",
        "N004": "20261030",
        "code": "AAPL"
      }
    ],
    "institution_holdings": [
      {
        "N002": "Blackrock, Inc.",
        "N003": "-5919598.0000",
        "N004": "20260930",
        "code": "AAPL"
      },
      {
        "N002": "Vanguard Capital Management Llc",
        "N003": "-3880127.0000",
        "N004": "20260930",
        "code": "AAPL"
      },
      {
        "N002": "State Street Corp",
        "N003": "7377549.0000",
        "N004": "20260930",
        "code": "AAPL"
      }
    ],
    "blocks": [
      {
        "code": "AAPL",
        "BlockName": "美股-科技类",
        "BlockContent": "公司从事设计、制造和销售智能手机、个人电脑、平板电脑、可穿戴设备和配件,以及其他各种相关服务。",
        "BlockId": "11",
        "BlockSatr": "☆☆☆☆☆"
      },
      {
        "code": "AAPL",
        "BlockName": "美股-明星股",
        "BlockContent": "公司为美股市场知名公司。",
        "BlockId": "18",
        "BlockSatr": "☆☆☆☆☆"
      },
      {
        "code": "AAPL",
        "BlockName": "美股-节日概念股",
        "BlockContent": "它的产品和服务包括iPhone、iPad、Mac、iPod、Apple Watch、Apple TV、一系列消费者和专业软件应用程序、iOS、macOS、watchOS和tvOS操作系统、iCloud、Apple Pay以及各种配件、服务和支持产品。它通过iTunes商店、App Store、Mac App Store、TV App Store、iBooks Store和Apple Music(统称为“互联网服务”)销售和提供数字内容和应用。该公司通过其零售商店、在线商店和直销团队,以及第三方蜂窝网络运营商、批发商、零售商和增值分销商,在全球范围内销售其产品。此外,该公司还通过其零售和在线商店销售各种与苹果兼容的第三方产品,包括应用软件和各种配件。它面向消费者、中小企业和教育机构、企业和政府客户。",
        "BlockId": "20",
        "BlockSatr": "☆☆☆"
      }
    ],
    "notices": [
      {
        "code": "AAPL",
        "isHighLight": "0",
        "T003": "11-16",
        "title": "Report of proposed sale of securities"
      }
    ]
  },
  "section_names": {
    "company": "公司信息",
    "finance_summary": "基础财务(近5期,金额单位=万美元)",
    "valuation": "估值快照",
    "revenue_by_region": "营收构成(按地区)",
    "revenue_by_business": "营收构成(按业务)",
    "dividends": "分红派息",
    "splits": "拆股合股",
    "ratings": "机构评级",
    "insider_changes": "内部人持股变动",
    "institution_changes": "大股东持仓变动",
    "institution_holdings": "机构持仓明细",
    "blocks": "板块概念",
    "notices": "公告提示"
  }
}

样例取自平台数据,finance_summary共 5 条,样例仅展示前 3 条;revenue_by_region共 5 条,样例仅展示前 3 条;revenue_by_business共 5 条,样例仅展示前 3 条;ratings共 10 条,样例仅展示前 3 条;insider_changes共 10 条,样例仅展示前 3 条;institution_changes共 10 条,样例仅展示前 3 条;institution_holdings共 10 条,样例仅展示前 3 条;blocks共 16 条,样例仅展示前 3 条。

最佳实践:单票深度调研用它一枪拿齐; 只要财务序列用 /us/stock/financial 更轻; insider_changes(内部人持股变动)+institution_changes(大股东变动)是资金面信号源。

认证方式、代码规范、错误码等通用约定见文档首页; 可在在线测试中直接调试本接口。