[ blog · comparison ]9 min read

API Cơ bản Doanh nghiệp: Bảng cân đối kế toán, Dòng tiền & Giao dịch nội bộ cho tác tử tài chính

Sarah ChoyĐăng ngày 16 tháng 6, 20269 phút đọc

Giá cho biết thị trường nghĩ gì; còn các yếu tố cơ bản cho biết thị trường đúng hay sai. Đây là một API cơ bản được định hình cho tác tử AI — các báo cáo, cổ tức và giao dịch nội bộ trong một endpoint — và cách nó so với SEC EDGAR thô và các nhà cung cấp API báo cáo.

Tóm tắt

•Cơ bản = lớp 'doanh nghiệp có thực sự khỏe mạnh không': bảng cân đối kế toán, báo cáo kết quả kinh doanh, dòng tiền, cổ tức, giao dịch nội bộ.
•Bạn có thể phân tích miễn phí từ SEC EDGAR (XBRL), nhưng chuẩn hóa XBRL qua các đơn vị nộp hồ sơ và kỳ báo cáo là công việc kỹ thuật thực sự và liên tục — và nó chỉ dành cho Mỹ và theo nhịp nộp hồ sơ, không được định hình cho truy vấn.
•Financials Search của API Pick trả về cả năm yếu tố cơ bản của công ty Mỹ sau một endpoint POST duy nhất — 200 credit/lần gọi, chỉ-khi-thành-công — được định hình sẵn cho suy luận của LLM.
•Giao dịch nội bộ (Form 4) và lịch sử cổ tức là những tín hiệu chưa được tận dụng: rẻ để lấy ở đây, đau đầu để ghép lại từ EDGAR.
•Kết hợp Financials với SEC Filings (văn bản định tính của 10-K/10-Q) và Markets (giá) để có một bức tranh có cơ sở đầy đủ.

Giá là quan điểm; các yếu tố cơ bản là bằng chứng

Một lệnh gọi dữ liệu thị trường cho tác tử của bạn biết một cổ phiếu có giá bao nhiêu. Nó không thể cho bạn biết liệu doanh nghiệp đứng sau có đang tăng trưởng, đang chìm trong nợ, hay đang bị chính các lãnh đạo của nó lặng lẽ bán đi hay không. Đó là lớp các yếu tố cơ bản — và đó là nơi một tác tử nghiên cứu chuyển từ "báo giá" sang "hình thành quan điểm".

Năm tập dữ liệu mang phần lớn tín hiệu: bảng cân đối kế toán, báo cáo kết quả kinh doanh, báo cáo lưu chuyển tiền tệ, lịch sử cổ tức và giao dịch nội bộ.

Cái giá của EDGAR

Tất cả những điều này đều công khai và miễn phí trên SEC EDGAR. Vướng mắc nằm ở XBRL. JSON company-facts khổng lồ và không nhất quán: cùng một khái niệm lại được gắn thẻ khác nhau giữa các đơn vị nộp hồ sơ, việc trình bày lại làm vẩn đục lịch sử, và bạn phải ánh xạ một phân loại tản mác sang một schema sạch trước khi bất cứ thứ gì ở phía sau có thể dùng được. Dữ liệu nội bộ (Form 4) và cổ tức là các loại hồ sơ riêng mà bạn phải tự phân tích. Làm việc này một lần cho một mã chứng khoán là một cuối tuần; làm nó một cách đáng tin cậy cho một tác tử truy vấn bất kỳ công ty nào là một pipeline được duy trì.

Các yếu tố cơ bản như một công cụ duy nhất

Financials Search trả về bảng cân đối kế toán, báo cáo kết quả kinh doanh, dòng tiền, cổ tức và giao dịch nội bộ cho các công ty đại chúng Mỹ sau một endpoint POST duy nhất — 200 credit mỗi lần gọi, chỉ-khi-thành-công, được định hình sẵn cho một LLM.

import httpx, os
API, HEADERS = "https://api.apipick.com/v1", {"x-api-key": os.environ["APIPICK_KEY"]}

def fundamentals(query: str):
    return httpx.post(f"{API}/search/financials", headers=HEADERS,
                      json={"query": query}).json()["results"]

fundamentals("Apple latest balance sheet and cash flow")
fundamentals("recent insider transactions at Meta")
fundamentals("Microsoft revenue and net income trend")

EDGAR vs. nhà cung cấp vs. bộ công cụ

	Phân tích SEC EDGAR	Nhà cung cấp API báo cáo	API Pick Financials
Chi phí	Miễn phí + kỹ thuật	Thuê bao	200 credit/lần gọi, chỉ khi thành công
Thiết lập	Pipeline chuẩn hóa XBRL	Tích hợp các endpoint có kiểu	Một endpoint, một hình dạng
Phạm vi	Mỹ, tổ chức theo hồ sơ	Sâu, lịch sử dài	Cơ bản Mỹ + nội bộ + cổ tức
Kiểu truy vấn	Theo hồ sơ/khái niệm	Tham số có kiểu	Ngôn ngữ tự nhiên
Phù hợp nhất cho	Một lần / kiểm soát toàn diện	Cơ bản là sản phẩm	Tác tử tài chính (một trong nhiều công cụ)

Bức tranh đầy đủ

Các yếu tố cơ bản kết hợp một cách tự nhiên với SEC Filings Search cho phía định tính (yếu tố rủi ro, MD&A, ngôn ngữ của earnings call) và với Markets Search cho giá. Cùng nhau, chúng là xương sống của tác tử nghiên cứu đầu tư. Một khóa, JSON xuyên suốt, chỉ-khi-thành-công. Bắt đầu miễn phí với 100 credit, không cần thẻ.

Câu hỏi thường gặp

Chẳng phải tôi có thể lấy các yếu tố cơ bản miễn phí từ SEC EDGAR sao?

Bạn có thể — dữ liệu company-facts và XBRL của EDGAR là miễn phí và chính thống. Cái giá phải trả là kỹ thuật: thẻ XBRL trôi dạt qua các đơn vị nộp hồ sơ và kỳ báo cáo, việc trình bày lại làm phức tạp lịch sử, và bạn phải ánh xạ hàng nghìn khái niệm phân loại sang một schema sạch trước khi một mô hình (hay một biểu đồ) có thể dùng chúng. Nó cũng chỉ dành cho Mỹ và được tổ chức theo hồ sơ, không theo câu hỏi. Với một công ty thỉnh thoảng, EDGAR là đủ. Với một tác tử truy vấn nhiều công ty bằng ngôn ngữ tự nhiên, một API đã chuẩn hóa tiết kiệm hàng tuần.

Bao gồm những gì — và có phải chỉ dành cho Mỹ không?

Bảng cân đối kế toán, báo cáo kết quả kinh doanh, báo cáo lưu chuyển tiền tệ, lịch sử cổ tức và giao dịch nội bộ cho các công ty đại chúng niêm yết tại Mỹ. Đây là các yếu tố cơ bản của Mỹ; với các tổ chức phát hành ngoài Mỹ bạn sẽ dùng một nguồn khác. Đối với chính văn bản hồ sơ (yếu tố rủi ro của 10-K, MD&A của 10-Q, earnings call), hãy dùng endpoint riêng SEC Filings Search.

Tại sao giao dịch nội bộ và cổ tức đáng được nhấn mạnh?

Chúng giàu tín hiệu và phiền phức khi tự ghép. Việc mua/bán của người nội bộ (Form 4 của SEC) là một tín hiệu hành vi được theo dõi sát; lịch sử cổ tức quan trọng đối với các bộ lọc thu nhập và chất lượng. Cả hai đều đòi hỏi phân tích các loại hồ sơ cụ thể từ EDGAR. Ở đây chúng là các trường hạng nhất trong cùng endpoint với các báo cáo.

So với các nhà cung cấp API báo cáo tài chính thì sao?

Các nhà cung cấp chuyên biệt (ví dụ các API báo cáo tài chính) cho các endpoint sâu, có kiểu rõ ràng và lịch sử dài — tuyệt vời nếu các yếu tố cơ bản là toàn bộ sản phẩm của bạn. Góc nhìn của API Pick thì khác: các yếu tố cơ bản như một công cụ trong một bộ (markets, SEC, kinh tế, tin tức) sau một khóa duy nhất, được định hình cho truy vấn của một tác tử, tính phí chỉ-khi-thành-công. Nếu bạn đang xây một tác tử tài chính thay vì một sản phẩm về các yếu tố cơ bản, thì bộ-trong-một-hình-dạng là con đường nhanh hơn.

Đây có phải là lời khuyên đầu tư không?

Không. Đây là dữ liệu tài chính công khai có cấu trúc cho nghiên cứu và làm cơ sở cho tác tử. Nó cung cấp thông tin cho phân tích của một người đủ năng lực hoặc một tác tử được giám sát; nó không phải lời khuyên và không được điều khiển giao dịch tự động mà thiếu trách nhiệm giải trình của con người và các biện pháp kiểm soát rủi ro.