Equity Management Platform
Developer API

GoldData APIs

Danh sách endpoint, tham số và response mẫu để tích hợp ví, token và giao dịch vào hệ thống bên ngoài.

Base URL https://www.golddata.vn/api/
Method POST
Content-Type application/x-www-form-urlencoded
Endpoints 10
Lưu ý tích hợp Gửi dữ liệu bằng POST body dạng form-urlencoded. Các endpoint có ghi “Yêu cầu token” cần truyền token lấy từ trang hồ sơ hoặc endpoint đăng nhập.
POST Không cần token

1. Lấy token người dùng

Xác thực tài khoản và trả về API token dùng cho các request ví/giao dịch.

Endpoint https://www.golddata.vn/api/token.html
Parameters
Field Type Diễn giải Demo
user string Tên đăng nhập demo
password string Mật khẩu demo
Response mẫu
{"code":200,"result":"ef095ac8a83f60ea980652fe8d60d379","msg":""}
POST Yêu cầu token

2. Tạo ví điện tử

Sinh một địa chỉ ví mới cho user sở hữu token.

Endpoint https://www.golddata.vn/api/wallet_gen.html
Parameters
Field Type Diễn giải Demo
token string API token của user ef095ac8a83f60ea980652fe8d60d379
Response mẫu
{"code":200,"result":{"wallet":"xxx"},"msg":"Tạo ví thành công !"}
POST Không cần token

3. Tạo link thanh toán

Tạo URL thanh toán/QR cho một ví nhận, số lượng và nội dung giao dịch.

Endpoint https://www.golddata.vn/api/pay_gen.html
Parameters
Field Type Diễn giải Demo
wallet string Ví nhận QTE2MGY1NDNlMDRhZDc2MTYyNjY4NjQzMg
amount decimal Số lượng token/ticket 1.52
description string Nội dung giao dịch Test API
callback url URL callback sau thanh toán https://www.golddata.vn/
Response mẫu
{"code":200,"result":"https://www.golddata.vn/pay/{wallet}/{amount}.html","msg":""}
POST Yêu cầu token

4. Lấy danh sách ví

Trả về các ví thuộc user đang sở hữu API token.

Endpoint https://www.golddata.vn/api/wallet_list.html
Parameters
Field Type Diễn giải Demo
token string API token của user ef095ac8a83f60ea980652fe8d60d379
Response mẫu
{"code":200,"result":[{"wallet":"xxx","amount_in_wallet":"0.00000000"}],"msg":""}
POST Yêu cầu token

5. Kiểm tra số dư ví

Kiểm tra số ticket/token hiện có trong một địa chỉ ví.

Endpoint https://www.golddata.vn/api/money_in_wallet.html
Parameters
Field Type Diễn giải Demo
token string API token của user ef095ac8a83f60ea980652fe8d60d379
wallet string Địa chỉ ví cần kiểm tra QTE2MGY1NDNlMDRhZDc2MTYyNjY4NjQzMg
Response mẫu
{"code":200,"result":{"wallet":"QTE2MGY1NDNlMDRhZDc2MTYyNjY4NjQzMg","amount":"0.00000000"},"msg":""}
POST Không cần token

6. Tìm giao dịch

Tìm danh sách giao dịch theo từ khóa và giới hạn số dòng trả về.

Endpoint https://www.golddata.vn/api/transaction.html
Parameters
Field Type Diễn giải Demo
keyword string Từ khóa trong giao dịch Test API
limit integer Số dòng tối đa 10
Response mẫu
{"code":200,"result":[],"msg":""}
POST Yêu cầu token

7. Lịch sử giao dịch ví

Lấy lịch sử chuyển/nhận của một ví theo API token.

Endpoint https://www.golddata.vn/api/transaction_history.html
Parameters
Field Type Diễn giải Demo
token string API token của user ef095ac8a83f60ea980652fe8d60d379
wallet string Địa chỉ ví cần xem lịch sử QTE2MGY1NDNlMDRhZDc2MTYyNjY4NjQzMg
Response mẫu
{"code":200,"result":[],"msg":""}
POST Yêu cầu token

8. Tổng giá trị ví

Tính tổng số token/ticket trong các ví thuộc user.

Endpoint https://www.golddata.vn/api/total_money.html
Parameters
Field Type Diễn giải Demo
token string API token của user ef095ac8a83f60ea980652fe8d60d379
Response mẫu
{"code":200,"result":"0.00000000","msg":""}
POST Yêu cầu token

9. Chuyển token giữa ví

Thực hiện chuyển token/ticket từ ví nguồn sang ví nhận.

Endpoint https://www.golddata.vn/api/transfer.html
Parameters
Field Type Diễn giải Demo
token string API token của user ef095ac8a83f60ea980652fe8d60d379
from_wallet string Ví nguồn QTE2MGY1NDNlMDRhZDc2MTYyNjY4NjQzMg
to_wallet string Ví nhận QTE2MGYzMjE5NThiMjZjMTYyNjU0NjU4MQ
amount decimal Số lượng cần chuyển 1.52
description string Nội dung giao dịch Test API
Response mẫu
{"code":200,"result":{"transaction_id":"xxx"},"msg":"Transfer success"}
POST Yêu cầu token

10. Kiểm tra checksum

Tính checksum để đối chiếu dữ liệu giao dịch phía client/server.

Endpoint https://www.golddata.vn/api/checksum.html
Parameters
Field Type Diễn giải Demo
token string API token của user ef095ac8a83f60ea980652fe8d60d379
ref string Mã tham chiếu giao dịch 105
amount decimal Số lượng giao dịch 1
from_wallet string Ví nguồn OWZmNDczNWZlNjNkNzU5MDRlMDJkZDc1NTA0YmEyNGQ
to_wallet string Ví nhận YjY0YzM2YTZiMTk5OTA0YzFjYWJjNWUzMjBmNzQ0ODA
Response mẫu
{"code":200,"checksum_transfer":"3152670793"}