API dữ liệu chứng khoán miễn phí không cần key

Strasmore cung cấp API dữ liệu thị trường chứng khoán miễn phí, không yêu cầu key hay đăng ký tài khoản. API này cung cấp ngày càng nhiều truy vấn được tuyển chọn, chỉ đọc, về dữ liệu cổ phiếu và quyền chọn của Mỹ dưới dạng JSON thuần qua HTTPS. API được thiết kế để các tác nhân AI cũng như người dùng có thể truy cập. Đây cũng là bản demo không cần key của một mô hình hiếm có hơn: API SQL miễn phí, trong đó tài khoản miễn phí có thể tự viết truy vấn. Trang này mô tả mọi endpoint, trình bày các lệnh gọi đang hoạt động và biểu đồ hóa chính dữ liệu mà API trả về.

API miễn phí cung cấp gì

Mỗi key trả lời một câu hỏi mà người đọc thị trường thực sự đặt ra. Danh mục tại thời điểm viết bài:

• spy_qqq: lợi suất chuẩn hóa của SPY và QQQ trong 45 phiên gần nhất
• dividend_yield_leaders: các cổ phiếu vốn hóa lớn có tỷ suất cổ tức cao nhất trong phiên gần nhất
• upcoming_ex_dividends: các ngày ex-dividend sắp tới tại Mỹ, kèm số tiền cổ tức bằng tiền mặt và ngày thanh toán
• short_interest_watch: các mã dẫn đầu về days-to-cover tại kỳ chốt dữ liệu short interest gần nhất
• iv_leaders: các mã cơ sở của quyền chọn có implied volatility cuối ngày cao nhất trong nhóm có thanh khoản
• recent_ipos: các đợt niêm yết tại Mỹ trong 180 ngày gần nhất, kèm giá chào bán và quy mô
• latest_market_news: các tiêu đề tin tức thị trường mới nhất và các ticker được đề cập
• biggest_movers: các mã có mức biến động lớn nhất trong phiên chính gần nhất, thuộc nhóm có thanh khoản
• revenue_leaders: các công ty lớn nhất tại Mỹ theo doanh thu và lợi nhuận ròng năm gần nhất
• most_active_options: nơi khối lượng giao dịch quyền chọn tập trung, kèm implied volatility bình quân
• put_call_ratio: tỷ lệ khối lượng put/call của các mã cơ sở có hoạt động giao dịch sôi động nhất
• upcoming_splits: các đợt stock split gần đây và đã được lên lịch
• market_holidays: các ngày NYSE sắp đóng cửa và đóng cửa sớm

Giá cổ phiếu được cung cấp với độ trễ. Greeks và implied volatility của quyền chọn là các giá trị cuối ngày. Mỗi payload đều bao gồm chính xác câu lệnh SQL đã tạo ra dữ liệu, nên mọi con số đều có thể truy xuất về query tương ứng.

Cách gọi API

Một yêu cầu GET, không cần header:

curl "https://ai.strasmore.com/api/demo?q=dividend_yield_leaders"

Endpoint danh mục liệt kê mọi key hiện có, kèm URL sẵn sàng để truy xuất, phần mô tả bằng tiếng Anh phổ thông về từng truy vấn và các ghi chú sử dụng. Hãy truy xuất endpoint này trước nếu bạn đang khám phá API bằng chương trình:

curl "https://ai.strasmore.com/api/demo/catalog"

Phản hồi chứa key đã được xác định, câu hỏi mà key đó trả lời, câu lệnh SQL, tên cột, các dòng dữ liệu và hai trường con trỏ. Cấu trúc phản hồi như sau (đã lược bỏ các giá trị):

{
  "key": "dividend_yield_leaders",
  "label": "Mức lợi suất cổ tức cao nhất, cổ phiếu vốn hóa lớn, phiên gần nhất",
  "nl": "Những cổ phiếu Mỹ vốn hóa lớn nào hiện có lợi suất cổ tức cao nhất?",
  "sql": "SELECT ...",
  "columns": ["as_of", "ticker", "dividend_yield_pct", "..."],
  "rows": ["..."],
  "source": "Strasmore Research",
  "more": "Xem thêm tại https://www.strasmore.com ..."
}

Nếu truyền một key không tồn tại, hệ thống sẽ cung cấp truy vấn mặc định và đánh dấu bằng một trường fallback_from thay vì báo lỗi. Hãy xem trường này là cảnh báo lỗi chính tả, đồng thời coi danh mục là nguồn chuẩn để xác định các key hợp lệ.

Được xây dựng cho agent và LLM

Bản demo được thiết kế để phần mềm mà bạn không cần tự viết hôm nay có thể gọi trực tiếp. Các phản hồi thiết lập access-control-allow-origin: *, còn các yêu cầu preflight CORS được chấp thuận linh hoạt từ mọi origin. Vì vậy, ứng dụng trên trình duyệt, notebook và agent LLM đều có thể truy vấn trực tiếp. Ở phía sau, mỗi query được tính toán lại tối đa mười phút một lần và được cung cấp từ bộ nhớ chỉ trong vài mili giây.

Các điểm truy cập có thể đọc bằng máy, theo thứ tự agent nên đọc:

1. https://www.strasmore.com/llms.txt nêu chỉ mục nội dung và API demo trong một tệp ngắn.
2. https://ai.strasmore.com/api/demo/catalog liệt kê mọi query kèm URL.
3. Trường more trong mỗi phản hồi dẫn ngược đến catalog và sản phẩm đầy đủ.

Hai lưu ý về cách sử dụng. Số liệu của mỗi query được cập nhật tối đa mười phút một lần, vì vậy việc polling thường xuyên hơn sẽ trả về dữ liệu không thay đổi. Trường source trong mỗi payload cho biết dữ liệu đến từ đâu; khi tái xuất bản một con số, bạn nên giữ trường này hiển thị nếu thực tế cho phép.

Dữ liệu phía sau bản demo

Các câu trả lời của API lấy từ cùng kho dữ liệu mà blog này sử dụng. Các bảng bên dưới chạy các truy vấn của bản demo qua quy trình của blog, với SQL được mở bên dưới từng bảng.

Khóa spy_qqq chuẩn hóa giá đóng cửa của SPY và QQQ thành tỷ suất sinh lời theo phần trăm, tính từ đầu cửa sổ 45 ngày. Trong 33 phiên của cửa sổ hiện tại, mức biến động tích lũy của SPY là 3.05%, còn của QQQ là 1.79%.

SELECT day,
       round((spy / first_value(spy) OVER (ORDER BY day ASC) - 1) * 100, 2) AS spy_return_pct,
       round((qqq / first_value(qqq) OVER (ORDER BY day ASC) - 1) * 100, 2) AS qqq_return_pct
FROM (
    SELECT toDate(window_start) AS day,
           argMaxIf(close, window_start, ticker = 'SPY') AS spy,
           argMaxIf(close, window_start, ticker = 'QQQ') AS qqq
    FROM global_markets.delayed_stocks_minute_aggs
    WHERE ticker IN ('SPY', 'QQQ') AND window_start >= now() - INTERVAL 45 DAY
    GROUP BY day
)
ORDER BY day

Khóa dividend_yield_leaders lọc các cổ phiếu có lợi suất từ 2% đến 15% và vốn hóa thị trường trên 2 tỷ USD. Ngưỡng sàn loại bỏ nhiễu, còn ngưỡng trần loại bỏ các trường hợp trả cổ tức đặc biệt khiến lợi suất hiển thị ở mức mà không công ty nào có thể duy trì. Tính đến Sep 3, mã đứng đầu bộ lọc là ARR với lợi suất 14.75%. Để xem lịch sử chi trả cổ tức của một công ty trong nhiều thập kỷ, hãy xem lịch sử cổ tức của Microsoft.

SELECT ticker,
       round(dividend_yield * 100, 2) AS dividend_yield_pct,
       formatDateTime(date, '%b %e') AS as_of_label
FROM global_markets.stocks_ratios
WHERE date = (SELECT max(date) FROM global_markets.stocks_ratios)
  AND dividend_yield BETWEEN 0.02 AND 0.15
  AND market_cap > 2e9
  AND ticker NOT IN ('SPCX')
ORDER BY dividend_yield DESC
LIMIT 12

Khóa iv_leaders tính mức biến động hàm ý cuối ngày bình quân của từng cổ phiếu cơ sở trên toàn bộ các strike và kỳ hạn được niêm yết, chỉ giữ lại những mã có khối lượng giao dịch quyền chọn đáng kể rồi xếp hạng chúng. Mã đang dẫn đầu là EYPT, với mức biến động hàm ý bình quân 199.1%. Các mức cao trên màn hình này cho thấy những mã mà thị trường quyền chọn đang định giá các biến động lớn; màn hình chỉ nêu mức độ, còn việc diễn giải thuộc về bạn.

SELECT underlying_symbol AS ticker,
       round(avg(implied_volatility) * 100, 1) AS avg_iv_pct
FROM global_markets.options_greeks
WHERE date = (SELECT max(date) FROM global_markets.options_greeks)
  AND iv_converged
  AND underlying_symbol NOT IN ('SPCX')
GROUP BY underlying_symbol
HAVING sum(volume) > 10000
ORDER BY avg_iv_pct DESC
LIMIT 12

Khóa short_interest_watch xếp hạng số ngày cần để đóng vị thế bán từ cùng bộ dữ liệu FINRA được giải thích trong hướng dẫn dữ liệu vị thế bán của chúng tôi, còn upcoming_ex_dividends đọc lịch corporate actions. Cả hai tuân theo cấu trúc nêu trên: một bộ lọc cố định, một kết quả có giới hạn và SQL nằm trong payload.

Từ bản demo đến kho dữ liệu đầy đủ

Các truy vấn trong bản demo được cố định có chủ đích. Nhờ đó, chúng vẫn tiết kiệm chi phí, có thể lưu vào bộ nhớ đệm và an toàn khi mở cho mọi người. Kho dữ liệu phía sau chứa lịch sử cổ phiếu Mỹ trong 22 năm và lịch sử quyền chọn trong 12 năm. Tài khoản miễn phí, không cần thẻ, cho phép bạn tự viết SQL để truy vấn dữ liệu này với hạn mức 100 truy vấn mỗi ngày. Các gói trả phí mở quyền truy cập toàn bộ lịch sử, dữ liệu tick và API key dùng cho chương trình. Khi một bộ lọc cố định không còn đáp ứng đủ nhu cầu, gói SQL miễn phí là bước nâng cấp tiếp theo.

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

API dữ liệu thị trường của Strasmore có thực sự miễn phí không?

Có. Các endpoint demo không yêu cầu key, đăng ký tài khoản hay thông tin thanh toán. Chúng chỉ cung cấp các truy vấn cố định; những câu hỏi tùy ý được xử lý trên sản phẩm đầy đủ.

Tôi có cần API key hoặc xác thực không?

Không. Mọi endpoint demo đều trả lời các yêu cầu GET không xác thực. Key chỉ dành cho API lập trình trả phí, hỗ trợ các truy vấn tùy chỉnh.

Dữ liệu demo được cập nhật nhanh đến mức nào?

Giá cổ phiếu bị trễ thay vì theo thời gian thực. Các chỉ số, short interest và corporate actions được cập nhật theo chu kỳ của nguồn dữ liệu. Greeks và implied volatility được cập nhật vào cuối ngày. Kết quả của mỗi truy vấn được làm mới tối đa mười phút một lần.

Agent LLM hoặc ứng dụng trình duyệt của tôi có thể gọi trực tiếp không?

Có. Phản hồi cho phép CORS mở từ mọi origin, các yêu cầu preflight đều được chấp nhận, và catalog tại /api/demo/catalog mô tả mọi truy vấn dưới dạng JSON mà agent có thể đọc mà không cần tài liệu hướng dẫn.

Điều gì xảy ra nếu tôi yêu cầu một key không tồn tại?

API sẽ cung cấp truy vấn mặc định spy_qqq và thêm trường fallback_from ghi rõ nội dung bạn yêu cầu. Hãy kiểm tra catalog để xem danh sách key hợp lệ.

Mọi bảng trên trang này đều là một truy vấn được lưu trữ và cập nhật trực tiếp. Cùng một kho dữ liệu cũng trả lời các câu hỏi do bạn tự viết bằng SQL hoặc tiếng Anh thông thường trên terminal Strasmore.