API BitcoinVN - Hướng dẫn tích hợp & Các trường hợp sử dụng

    BitcoinVN cung cấp REST API cho phép nhà phát triển tích hợp sàn giao dịch tiền mã hóa tức thì vào ứng dụng của họ. Tài liệu tương tác đầy đủ có tại bitcoinvn.io/api/doc.

    Bắt đầu

    1. Lấy API key: Đăng ký tại bitcoinvn.io và tạo API key từ bảng điều khiển (bitcoinvn.io/api-keys)
    2. Khám phá endpoints: Xem Swagger UI tương tác tại bitcoinvn.io/api/doc hoặc tải OpenAPI spec tại bitcoinvn.io/api/doc.json
    3. Bắt đầu sử dụng: Tạo báo giá, gửi lệnh và nhận thông báo webhook

    Xác thực

    Các endpoint công khai (tỷ giá, thông tin tài sản, tra cứu đơn hàng) không cần xác thực. Đối với endpoint riêng tư (tạo đơn hàng, số dư, KYC, staking), thêm API key vào header X-API-KEY cho mỗi yêu cầu.

    Quy trình cơ bản

    1. GET /api/info - Khám phá tài sản và phương thức chuyển tiền được hỗ trợ
    2. POST /api/quotes - Khóa tỷ giá trong 15 phút
    3. POST /api/orders - Tạo đơn hàng bằng ID báo giá và thông tin thanh toán
    4. Khách hàng gửi tiền đến địa chỉ được cung cấp trong phản hồi đơn hàng
    5. GET /api/orders/{shortId} - Theo dõi trạng thái đơn hàng hoặc lắng nghe webhook

    Các trường hợp sử dụng

    • Tổng hợp giao dịch: Liệt kê BitcoinVN là nhà cung cấp sàn giao dịch với hơn 100 tài sản. Sử dụng endpoint tỷ giá và báo giá công khai để hiển thị giá cạnh tranh, sau đó gửi lệnh thay mặt người dùng.
    • Thanh toán cho người bán: Chấp nhận thanh toán bằng tiền mã hóa từ khách hàng trên toàn thế giới và thanh toán bằng bất kỳ tài sản được hỗ trợ nào.
    • Ví và ứng dụng: Nhúng chức năng giao dịch trực tiếp vào ví hoặc ứng dụng của bạn chỉ với vài lệnh API. Người dùng có thể hoán đổi giữa các tài sản mà không cần rời khỏi giao diện của bạn.
    • Giao dịch tự động: Xây dựng bot theo dõi tỷ giá qua endpoint ticker và thực hiện giao dịch tự động khi đạt giá mục tiêu.
    • Kế toán và báo cáo: Sử dụng endpoint số dư và sổ cái để lấy lịch sử giao dịch cho việc ghi sổ, đối chiếu hoặc báo cáo thuế.
    • Công cụ tuân thủ: Tận dụng endpoint quản lý danh sách đen để sàng lọc địa chỉ crypto hoặc địa chỉ IP và đặt ngưỡng đóng băng cho các giao dịch bị gắn cờ.
    • Bảng điều khiển staking: Truy vấn các ưu đãi staking hiện tại và quản lý tùy chọn auto-stake qua giao diện của bạn.

    Tính năng chính

    • Hơn 100 tài sản được hỗ trợ trên nhiều mạng lưới
    • Báo giá ràng buộc với giá đảm bảo trong 15 phút
    • Thông báo webhook để cập nhật trạng thái đơn hàng theo thời gian thực
    • Không cần dữ liệu cá nhân cho giao dịch crypto-to-crypto cơ bản
    • OpenAPI 3.0 spec để tạo mã client dễ dàng

    Hỗ trợ nhà phát triển

    Để được hỗ trợ tích hợp, tham gia nhóm Telegram dành cho nhà phát triển hoặc liên hệ [email protected].

    Published