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

Strasmore cung cấp một API dữ liệu thị trường chứng khoán miễn phí, không cần key và không cần đăng ký. API này cung cấp các truy vấn read-only được tuyển chọn về dữ liệu cổ phiếu và options tại Mỹ dưới dạng JSON qua HTTPS. Dịch vụ này được thiết kế để phục vụ cả người dùng lẫn các AI agent. Đây cũng là bản demo không cần key cho một tính năng hiếm gặp hơn: một SQL API miễn phí cho phép tài khoản miễn phí tự viết truy vấn. Trang này tài liệu hóa mọi endpoint, hiển thị các lệnh gọi hoạt động và biểu đồ hóa cùng loại dữ liệu mà API trả về.

Nội dung cung cấp bởi API miễn phí

Mỗi key sẽ trả lời một câu hỏi mà người đọc thị trường thường quan tâm. Danh mục tính đến thời điểm viết bài:

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

Giá cổ phiếu có độ trễ. Các chỉ số options greeks và implied volatility là giá trị cuối ngày. Mọi payload đều bao gồm câu lệnh SQL chính xác đã tạo ra dữ liệu đó, vì vậy mọi con số đều có thể được truy xuất từ truy vấn của nó.

Cách gọi API

Chỉ cần một yêu cầu GET, không cần header:

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

Endpoint catalog liệt kê mọi key có sẵn kèm theo URL để truy xuất, mô tả tiếng Anh đơn giản cho mỗi truy vấn và các lưu ý sử dụng. Hãy gọi endpoint này trước nếu bạn đang tìm kiếm API bằng lập trình:

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

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

{
  "key": "dividend_yield_leaders",
  "label": "Highest dividend yields, large caps, latest session",
  "nl": "Which large-cap US stocks currently have the highest dividend yields?",
  "sql": "SELECT ...",
  "columns": ["as_of", "ticker", "dividend_yield_pct", "..."],
  "rows": ["..."],
  "source": "Strasmore Research",
  "more": "Get more at https://www.strasmore.com ..."
}

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

Được thiết kế cho agent và LLM

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

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

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

Hai lưu ý về quy tắc sử dụng. Các con số trong mỗi truy vấn chỉ làm mới tối đa mười phút một lần, vì vậy việc polling nhanh hơn mức đó sẽ trả về dữ liệu giống hệt nhau. Trường source bên trong mỗi payload cho biết nguồn gốc của dữ liệu; hãy giữ trường này hiển thị khi có thể nếu bạn tái xuất bản một con số.

Dữ liệu đằng sau bản demo

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

Khóa spy_qqq chuẩn hóa giá đóng cửa của SPY và QQQ thành tỷ lệ lợi nhuận phần trăm tính từ thời điểm bắt đầu của cửa sổ 45 ngày. Trong 30 phiên của cửa sổ hiện tại, biến động tích lũy của SPY đo lường -1.6% và của QQQ đo lường -5.69%.

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ó tỷ suất cổ tức từ 2% đến 15% với vốn hóa thị trường trên 2 tỷ USD. Mức sàn giúp loại bỏ nhiễu và mức trần loại bỏ các sai số từ cổ tức đặc biệt mà không công ty nào có thể duy trì lâu dài. Tính đến Jul 17, cổ phiếu đứng đầu danh sách là STRC với mức 13.45%. Để biết lịch sử chi trả của một công ty cụ thể 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 toán độ biến động hàm ý (implied volatility) trung bình cuối ngày cho mỗi tài sản cơ sở dựa trên tất cả các mức giá thực hiện (strike) và ngày đáo hạn được niêm yết, giữ lại các mã có khối lượng quyền chọn đáng kể và xếp hạng chúng. Mã dẫn đầu hiện tại là SNXX với độ biến động hàm ý trung bình là 299.1%. Chỉ số cao trên bảng này cho biết các mã mà thị trường quyền chọn đang định giá cho các biến động lớn; bảng này cung cấp mức độ biến động và để bạn tự đưa ra nhận định.

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 để bù đắp vị thế bán khống (days-to-cover) từ cùng một tập dữ liệu của FINRA đã được giải thích trong hướng dẫn dữ liệu short-interest của chúng tôi, và upcoming_ex_dividends đọc lịch sự kiện doanh nghiệp. Cả hai đều tuân theo mô hình trên: một bộ lọc cố định, một kết quả có giới hạn và mã SQL trong phần dữ liệu trả về.

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: chúng luôn có chi phí thấp, có thể lưu vào bộ nhớ đệm (cacheable) và an toàn khi mở cho tất cả mọi người. Kho dữ liệu phía sau chứa 22 năm cổ phiếu Mỹ và 12 năm lịch sử quyền chọn (options). Một tài khoản miễn phí (không cần thẻ) có thể tự viết truy vấn SQL để truy xuất dữ liệu với giới hạn 100 truy vấn mỗi ngày. Các gói trả phí sẽ mở khóa toàn bộ lịch sử, dữ liệu tick và các khóa API lập trình. Khi các màn hình 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.

FAQ

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, không cần đăng ký và không cần thông tin thanh toán. Các endpoint này chỉ phục vụ các truy vấn cố định; các truy vấn tùy chỉnh khác sẽ yêu cầu sử dụng sản phẩm đầy đủ.

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

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

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

Giá cổ phiếu (equity) bị trễ chứ không phải thời gian thực. Các chỉ số tỷ lệ (ratios), tỷ lệ bán khống (short interest) và các sự kiện doanh nghiệp được cập nhật theo chu kỳ của nguồn dữ liệu gốc. Các chỉ số Greeks và biến động hàm ý (implied volatility) là dữ liệu 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.

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

Có. Các phản hồi hỗ trợ CORS mở từ mọi nguồn, các yêu cầu preflight đều thành công ở mọi nơi, và danh mục tại /api/demo/catalog mô tả mọi truy vấn dưới dạng JSON mà một agent có thể đọc được mà không cần tài liệu hướng dẫn.

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

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

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