Xác thực

Để đảm bảo quyền truy cập an toàn vào API của Nami Exchange, tất cả các yêu cầu phải được xác thực bằng API key. Làm theo các bước dưới đây để đăng ký tài khoản, hoàn thành xác minh KYC, bật 2FA, và tạo API key của bạn.

Tạo Tài Khoản

Bạn cần có tài khoản Nami Exchange để sử dụng API. Làm theo các bước sau để đăng ký:

  1. Truy cập trang Đăng ký: Đi đến Đăng ký Nami Exchange.

  2. Điền thông tin đăng ký: Cung cấp các thông tin cần thiết, bao gồm địa chỉ email và mật khẩu.

  3. Xác minh Email: Sau khi gửi mẫu đăng ký, kiểm tra email của bạn để nhận liên kết xác minh. Nhấp vào liên kết để xác minh địa chỉ email của bạn.

  4. Đăng nhập: Sau khi email của bạn được xác minh, đăng nhập vào tài khoản bằng thông tin đăng nhập của bạn.

Hoàn Thành Xác Minh KYC

Xác minh KYC (Biết Khách Hàng) giúp đảm bảo môi trường giao dịch an toàn. Làm theo các bước sau để hoàn thành:

  1. Tìm phần xác minh KYC: Truy cập vào phần cài đặt tài khoản và tìm mục xác minh KYC.

  2. Nộp tài liệu yêu cầu: Cung cấp các tài liệu cần thiết, chẳng hạn như CMND hoặc hộ chiếu và giấy tờ xác minh địa chỉ. Những tài liệu này giúp xác minh danh tính của bạn và bảo vệ chống lại các hoạt động gian lận.

  3. Chờ duyệt: Quá trình xác minh có thể mất thời gian. Bạn sẽ nhận thông báo qua email khi xác minh KYC của bạn được chấp nhận.

Hướng dẫn chi tiết hơn: ở đây

Bật Xác Thực Hai Yếu Tố (2FA)

Để tăng cường bảo mật, bạn cần bật Xác Thực Hai Yếu Tố (2FA). Làm theo các bước sau:

  1. Truy cập phần Cài đặt Bảo mật: Đi đến phần cài đặt tài khoản và tìm mục Xác thực Hai Yếu Tố (2FA).

  2. Bật 2FA: Làm theo hướng dẫn để bật 2FA, thường là quét mã QR bằng ứng dụng xác thực (chẳng hạn như Google Authenticator) và nhập mã được tạo.

Hướng dẫn chi tiết hơn: ở đây

Tạo API Key

Sau khi đăng ký, hoàn thành xác minh KYC và bật 2FA, bạn có thể tạo API key:

  1. Truy cập phần Cài đặt API: Đi đến phần cài đặt tài khoản và tìm mục cài đặt API.

  2. Tạo API Key mới: Nhấp vào nút "Tạo API Key". API key mới của bạn sẽ được hiển thị. Sao chép và lưu trữ key này một cách an toàn. Bạn sẽ cần key này để xác thực các yêu cầu API của mình.

Bằng cách làm theo các bước trên, bạn có thể tạo API key cho giao dịch Spot trên Nami Exchange. Hãy đảm bảo giữ API key của bạn an toàn và chỉ sử dụng từ các địa chỉ IP được ủy quyền nếu bạn có thiết lập hạn chế.

Xác Thực Bằng API Key

Xác thực được thực hiện bằng cách gửi các header HTTP sau:

  • apiKey: API key công khai của bạn (truyền qua header "x-api-key")

  • apiSecret: API secret key của bạn (dùng để băm chuỗi truy vấn)

  • api-signature: Chữ ký của yêu cầu bạn đang thực hiện. Nó được tính bằng cách sử dụng hàm hex(HMAC_SHA256(apiSecret, queryString)). Xem các ví dụ tính toán dưới đây. Gợi ý: queryString được tạo từ các tham số truy vấn của bạn (không cần dữ liệu truy vấn) và timestamp khi bạn thực hiện yêu cầu.\

Ví Dụ

apiKey = 'N3LbmwMAXcObdVYdP8KTMYjsi94CUpEh8C3F2xhDKdxbkfQn8Bi3FQP7LudeN9Vb'
apiSecret = 'UNCZHD1e4501X1WGO9PqjGJBDqWoNjUlc05YZTy38t9Wd7rHWmrmtfKfb1Vpb5RH'


Yêu cầu GET đơn giản
Lấy số dư ví người dùng từ `/api/v4/user/balance`

method = 'GET'
url = `/api/v4/user/balance`
params = {
    type: '0' # Loại 0 nghĩa là ví Spot
}
data = {}

Lấy timestamp hiện tại:
    timestamp = 1721284769720 # Thứ Năm, ngày 18 tháng 7, 2024 6:39:29.720 AM

Tạo query string:
    queryString = 'type=0&timestamp=1721284769720'

Tạo chữ ký:
    signature = 'CryptoJs.HmacSHA256(queryString, apiSecret).toString()'
    signature = '2cc8df81fc34801e6b6f7dbaf79e72ab098bf5461973239689e32e71368cd145'
    
Truy vấn đầy đủ:
    path = '/api/v4/user/balance?type=0&timestamp=1721284692786&signature=2cc8df81fc34801e6b6f7dbaf79e72ab098bf5461973239689e32e71368cd145'

Yêu cầu đầy đủ:
    curl --location 'https://nami.exchange/api/v4/user/balance?type=0&timestamp=1721284769720&signature=2cc8df81fc34801e6b6f7dbaf79e72ab098bf5461973239689e32e71368cd145' \
    --header 'x-api-key: N3LbmwMAXcObdVYdP8KTMYjsi94CUpEh8C3F2xhDKdxbkfQn8Bi3FQP7LudeN9Vb' \

   

Yêu cầu POST đơn giản
Tạo đơn hàng mới từ '/api/v4/spot/order'

method = 'POST'
url = '/api/v4/spot/order'
params = {
    symbol: 'NAMIVNDC',
    side: 'SELL',
    type: 'LIMIT',
    quantity: 50000,
    price: 600,
}

Lấy timestamp hiện tại:
    timestamp = 1721284021975 # Thứ Năm, ngày 18 tháng 7, 2024 6:27:01.975 AM
    
Tạo query string:
    queryString = 'symbol=NAMIVNDC&side=SELL&type=LIMIT&quantity=50000&price=600&timestamp=1721284021975'
    
Tạo chữ ký:
    signature = 'CryptoJs.HmacSHA256(queryString, apiSecret).toString()'
    signature = '87455e30b15d4d2fe234eeec92cfc165f8b8647bf583ce09f0bdb6b3c6a09b77'

Truy vấn đầy đủ:
    path = '/api/v4/spot/order?symbol=NAMIVNDC&side=SELL&type=LIMIT&quantity=50000&price=600&timestamp=1721284021975&signature=87455e30b15d4d2fe234eeec92cfc165f8b8647bf583ce09f0bdb6b3c6a09b77'

Yêu cầu đầy đủ:
    curl --location --request POST 'https://nami.exchange/api/v4/spot/order?symbol=NAMIVNDC&side=SELL&type=LIMIT&quantity=50000&price=600&timestamp=1721284021975&signature=87455e30b15d4d2fe234eeec92cfc165f8b8647bf583ce09f0bdb6b3c6a09b77' \
    --header 'Content-Type: application/json' \
    --header 'x-api-key: N3LbmwMAXcObdVYdP8KTMYjsi94CUpEh8C3F2xhDKdxbkfQn8Bi3FQP7LudeN9Vb' \
PreviousLịch sử thay đổiNextREST API

Last updated