Bằng cách sử dụng điểm cuối nạp/rút của REST API, khách hàng có thể nạp/rút tiền vào/ra tài khoản Kraken của họ và yêu cầu trạng thái thời gian thực của giao dịch nạp/rút tiền.

Việc nạp/rút tiền phải trải qua nhiều giai đoạn giữa yêu cầu ban đầu và giao dịch hoàn tất, do đó, các điểm cuối nạp/rút sẽ trả về giá trị trạng thái khác nhau tùy thuộc vào thời điểm chúng được gọi.

Lưu ý rằng các giá trị trạng thái ban đầu được lấy từ trang 16/17 của tài liệu Giao thức trao đổi tài chính Internet (IFEX), nhưng các giá trị này đã được sửa đổi một chút để phù hợp hơn với các giao dịch tiền điện tử (ví dụ: không phải tất cả các giá trị trạng thái có thể đều được sử dụng).

Sau đây là một số ví dụ về cách các giá trị trạng thái trên sẽ xuất hiện trong phản hồi từ điểm cuối DepositStatus:

Trạng thái đã thực hiện:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906dde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Settled"}]}

Trạng thái thành công:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906tdde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Success"}]}

Sau đây là một số ví dụ về cách các giá trị trạng thái trên sẽ xuất hiện trong phản hồi từ điểm cuối WithdrawStatus:

Trạng thái ban đầu:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Initial"}]}

Trạng thái đang chờ xử lý:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Pending"}]}

Trạng thái đã thực hiện:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Settled"}]}

Trạng thái thành công:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Success"}]}

Trạng thái thất bại:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Failure","status-prop":"canceled"}]}}

Thông tin bổ sung về việc nạp/rút tiền có sẵn trên trang hỗ trợ nạp/rút tiền mặt và nạp/rút tiền điện tử của chúng tôi.

Điểm cuối OHLC của REST API chỉ cung cấp một lượng dữ liệu lịch sử hạn chế, cụ thể là 720 điểm dữ liệu của khoảng thời gian được yêu cầu. Ví dụ, yêu cầu dữ liệu OHLC theo khoảng thời gian 1 phút sẽ trả về dữ liệu gần đây nhất trong 720 phút (12 giờ).

Đối với các ứng dụng yêu cầu dữ liệu OHLC hoặc dữ liệu tích tắc bổ sung, có thể truy xuất toàn bộ lịch sử giao dịch của thị trường (thời gian và doanh số lịch sử) thông qua điểm cuối REST API Trades. Sau đó, có thể tạo OHLC cho bất kỳ khung thời gian và khoảng thời gian nào từ dữ liệu thời gian và doanh số lịch sử.

Điểm cuối Trades sử dụng tham số tùy chọn có tên là since, tham số này chỉ định ngày/giờ bắt đầu của dữ liệu. Giá trị since là mốc thời gian UNIX ở độ phân giải nano giây (mốc thời gian UNIX chuẩn tính bằng giây với 9 chữ số bổ sung).

Ví dụ: lệnh gọi đến điểm cuối Trades như https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000 sẽ trả về thời gian và doanh số lịch sử cho XBT/USD từ ngày 1 tháng 6 năm 2019 lúc 00:00:00 UTC:

{"error":[],"result":{"XXBTZUSD":[["8552.90000","0.03190270",1559347203.7998,"s","m",""],["8552.90000","0.03155529",1559347203.8086,"s","m",""],["8552.90000","0.00510797",1559347203.9664,"s","m",""],["8552.90000","0.09047336",1559347203.9789,"s","m",""],["8552.90000","0.00328738",1559347203.9847,"s","m",""],["8552.90000","0.00492152",1559347203.9897,"s","m",""],["8552.90000","0.00201848",1559347203.9937,"s","m",""],["8552.90000","0.11422068",1559347203.9993,"s","m",""],["8552.90000","0.00425858",1559347204.071,"s","m",""],["8552.90000","0.00427679",1559347204.0762,"s","m",""],["8552.90000","0.06381401",1559347204.1662,"s","m",""]
...
["8579.50000","0.05379597",1559350785.248,"s","l",""],["8579.50000","0.94620403",1559350785.2936,"s","l",""],["8578.10000","0.45529068",1559350785.297,"s","l",""]],"last":"1559350785297011117"}}

Các cuộc gọi tiếp theo đến điểm cuối Trades phải thay thế giá trị của tham số since bằng giá trị của tham số last từ kết quả của cuộc gọi trước đó, chẳng hạn như https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.

Sử dụng giá trị đặc biệt since là 0 (zero) sẽ trả về thời gian lịch sử và doanh số từ khi thị trường bắt đầu (bắt đầu từ giao dịch đầu tiên).

Tham chiếu người dùng là ID lệnh do khách hàng cung cấp có thể được sử dụng thay cho ID lệnh thực tế (do API cung cấp) cho một số tác vụ quản lý lệnh (đặc biệt là hủy lệnh).

Tài liệu tham khảo của người dùng được triển khai sao cho linh hoạt nhất có thể và do đó có thể được sử dụng theo nhiều cách khác nhau, bao gồm:

Tham chiếu người dùng phải là giá trị số từ 1 đến 2.147.483.647 (về cơ bản là bất kỳ số 32 bit dương nào) và do đó có thể được triển khai như một bộ đếm đơn giản, như một giá trị 32 bit có dấu ngẫu nhiên hoặc thậm chí như một mốc thời gian tính bằng giây (mặc dù điều này sẽ không thành công sau ngày 19 tháng 1 năm 2038 lúc 3:14:07 UTC).

Vấn đề này có thể liên quan đến Cloudflare:

https://support.cloudflare.com/hc/en-us/articles/200169226-Why-am-I-getting-a-403-error-

LƯU Ý: Kraken đã bật "Kiểm tra tính toàn vẹn của trình duyệt".

Điều này có thể xảy ra nếu yêu cầu của bạn chứa các tiêu đề nghi ngờ. Ví dụ, yêu cầu của bạn có thể thiếu một tác nhân người dùng, hoặc sử dụng một tác nhân người dùng không chuẩn; vì vậy hãy kiểm tra các tiêu đề yêu cầu của bạn.

Nếu bạn không thể tạo bất kỳ yêu cầu tiêu chuẩn nào mà hệ thống của chúng tôi cho phép, hãy gửi cho chúng tôi một bản sao đầy đủ của yêu cầu mà bạn đang cố gắng, bao gồm địa chỉ IP của bạn và tất cả các tiêu đề. Thông tin này sẽ cho phép chúng tôi điều tra thêm.

Lệnh thực tế nhỏ và/hoặc các lệnh có giá cực cao

Để thử nghiệm API toàn diện sử dụng Tham số xác thực, chúng tôi khuyên bạn nên đặt các lệnh thị trường rất nhỏ (lệnh cho kích thước lệnh tối thiểu), hoặc các lệnh giới hạn có giá cách xa giá thị trường hiện tại (đặt một lệnh giới hạn để bán ETH/USD ở mức 800 đô la khi giá thị trường là 200 đô la).

Thử nghiệm bằng cách sử dụng các lệnh trực tiếp cho phép mã API của bạn tương tác với API của chúng tôi trong điều kiện thực tế, do đó mọi khía cạnh của bài kiểm tra sẽ chính xác (cách mà các lệnh của bạn ảnh hưởng đến sổ lệnh, v.v.).

Vì lý do bảo mật, gần đây chúng tôi đã ngừng hỗ trợ TLS 1.0 và 1.1. Nếu bạn gặp phải thông báo lỗi kết nối SSL/TLS khi cố gắng kết nối với API của chúng tôi, có thể do việc sử dụng một trong những tiêu chuẩn đã lỗi thời này. Bạn sẽ cần phải sửa đổi khách hàng API của mình để buộc sử dụng TLS 1.2/1.3 hoặc nâng cấp phiên bản .NET của bạn lên 4.6 hoặc cao hơn, phiên bản này sử dụng TLS 1.2/1.3 làm tiêu chuẩn.

Có thể sử dụng Bảng tính Google sau đây để tính toán chữ ký xác thực REST API cho bất kỳ tổ hợp dữ liệu đầu vào nào:

Máy tính có thể được sử dụng để xác minh rằng thuật toán xác thực đã được triển khai đúng cách, từ đó tránh các vấn đề tiềm ẩn (đặc biệt là các lỗi khóa không hợp lệ không mong muốn) sau này trong chu kỳ phát triển.

Vì lý do bảo mật, chúng tôi khuyên bạn nên sử dụng máy tính xác thực với khóa API tạm thời, và sau đó xóa API key khỏi tài khoản của bạn khi việc triển khai chữ ký xác thực của bạn được chứng minh là đúng.

Lợi ích chính từ việc sử dụng các lớp bọc thư viện khách hàng của chúng tôi là bạn không cần phải tốn thời gian/công sức để tái phát minh bánh xe cho việc tạo chữ ký API, nó đã được thực hiện cho bạn.

Nếu bạn chỉ có ý định thực hiện lệnh gọi đến các phương thức công khai, thì bạn có thể chọn không sử dụng các thư viện khách hàng vì không cần xác thực.

Danh sách các lớp bọc có sẵn mà bạn có thể tìm thấy ở đây.