Dữ liệu tài chính & thị trường Nhịp Số
Tích hợp thời tiết, giá vàng, giá bạc, xăng dầu, ngoại tệ, lãi suất, bóng đá, ô tô, chứng khoán, thể thao, địa lý vào ứng dụng của bạn qua REST API đơn giản. Mọi endpoint dưới /v1, trả JSON.
Thời tiết
Dự báo cho 34 tỉnh thành: hiện tại, theo giờ (24h) và 7 ngày tới.
8 endpoints
Xem tài liệuGiá vàng
Giá mua/bán vàng của SJC, DOJI, PNJ, BTMC, BTMH... kèm biểu đồ lịch sử từng loại.
7 endpoints
Xem tài liệuGiá bạc
Giá mua/bán bạc của BTMC, DOJI, Phú Quý, BTMH... kèm biểu đồ lịch sử từng loại.
7 endpoints
Xem tài liệuXăng dầu
Giá bán lẻ các loại xăng E5, RON95 và dầu DO, KO tại vùng I và vùng II.
7 endpoints
Xem tài liệuNgoại tệ
Tỷ giá mua/bán giữa các ngoại tệ và VNĐ tại Vietcombank, BIDV, ACB, Techcombank...
7 endpoints
Xem tài liệuLãi suất
So sánh lãi suất huy động theo kỳ hạn 1–36 tháng giữa các ngân hàng.
7 endpoints
Xem tài liệuBóng đá
Lịch thi đấu, kết quả trực tiếp và bảng xếp hạng các giải trong nước & quốc tế.
18 endpoints
Xem tài liệuÔ tô
Tổng hợp thông tin ô tô tại Việt Nam: hãng xe, dòng xe, thông số kỹ thuật và doanh số bán hàng. Số liệu doanh số từ VAMA, Hyundai Thành Công, VinFast.
17 endpoints
Xem tài liệuChứng khoán
Chỉ số, cổ phiếu và ngành chứng khoán Việt Nam — giá gần thời gian thực, lịch sử OHLCV và chỉ số cơ bản P/E, P/B.
12 endpoints
Xem tài liệuThể thao
Bảng xếp hạng huy chương các kỳ thi đấu: Olympic, SEA Games, ASIAD, Asian Games.
8 endpoints
Xem tài liệuĐịa lý
Dữ liệu địa lý hành chính: tỉnh/thành, quận/huyện, phường/xã.
8 endpoints
Xem tài liệuTập dữ liệu
Đọc dữ liệu của các tập dữ liệu công khai trong thư viện Data Studio, hoặc tập dữ liệu riêng của bạn qua secret key.
4 endpoints
Xem tài liệuBiểu đồ
Đọc thông tin các biểu đồ công khai trong thư viện Data Studio, hoặc của bạn qua secret key.
4 endpoints
Xem tài liệucollections
2 endpoints
Xem tài liệutags
4 endpoints
Xem tài liệuNhúng từ URL
Nhúng nội dung từ bất kỳ URL hỗ trợ oEmbed — chỉ cần dán link.
1 endpoint
Xem tài liệuXác thực & khoá
Public key (khoá công khai)
nhipso-pk-… — đặt trong HTML/JavaScript của website: nhúng widget và gọi API thẳng từ browser. Chỉ chạy khi origin của trang nằm trong allowlist của key (khai tại tài khoản); giới hạn theo IP; mỗi lượt gọi tính vào quota API tháng của bạn — trang càng nhiều người xem càng tốn quota. Không trả header quota.
Secret key (khoá bí mật)
nhipso-sk-… — chỉ dùng phía server (curl, Node, PHP, CMS). Không bao giờ đặt vào browser: gateway từ chối Secret key gửi từ origin lạ. Rate limit theo key theo gói và quota API tháng; trả header quota.
Tạo & quản lý cả hai loại tại /tai-khoan/api-keys. Nhúng widget cũng dùng Public key — xem /tai-lieu/embed.
Xác thực request
Gửi key qua header x-api-key (hoặc Authorization: Bearer <key>). Từ server với Secret key:
curl https://api.nhipso.vn/v1/gold \ -H "x-api-key: nhipso-sk-xxxxxxxxxxxx"
Từ browser với Public key (trang phải chạy trên origin đã khai báo):
const res = await fetch("https://api.nhipso.vn/v1/gold", {
headers: { "x-api-key": "nhipso-pk-xxxxxxxxxxxx" },
});
const { data } = await res.json();Playground (/tai-lieu/api) chạy trên nhipso.vn nên dùng được cả hai loại key; ví dụ trong tab Browser mới là cách dùng Public key trên website của bạn.
Rate limit & quota tháng
Public key: rate limit theo (key, IP). Secret key: rate limit theo key theo gói. Cả hai cùng tính vào một quota API tháng của tài khoản. Chỉ response của Secret key mang thêm header quota; Public key không trả header quota — khi hết quota cả hai đều nhận 429 QUOTA_EXCEEDED.
| Header | Ý nghĩa |
|---|---|
| X-Quota-Remaining | Số lượt gọi còn lại trong tháng (Secret key) |
| X-Quota-Reset | Unix timestamp đầu tháng sau, khi quota reset (Secret key) |
Mã lỗi xác thực
| HTTP | Mã lỗi | Nguyên nhân |
|---|---|---|
| 401 | UNAUTHORIZED | Thiếu, sai hoặc đã thu hồi key |
| 403 | ORIGIN_NOT_ALLOWED | Public key gọi từ origin không nằm trong allowlist (hoặc allowlist rỗng) |
| 403 | FORBIDDEN | Secret key gửi từ browser (origin lạ) |
| 429 | RATE_LIMITED | Vượt rate limit phút |
| 429 | QUOTA_EXCEEDED | Hết quota API tháng (cả hai loại key); reset đầu tháng sau |
Pricing
Pricing
Thông tin gói Free / Member sẽ được cập nhật sớm.