Tạo lệnh thị trường

post https://api.cryptomus.com/v2/user-api/convert/ Sao chép

Lời yêu cầu

Tham số truy vấn

TênKiểu tham sốSự định nghĩa
from*stringmax:10Tiền tệ để chuyển đổi Từ
to*stringmax:10Tiền tệ để chuyển đổi sang
amount*stringSố tiền cần chuyển đổi sang tiền tệ từNếu có xu trong số tiền, hãy gửi chúng với dấu phân cách '.'
Ví dụ: 10.28

Kiểu tham số

stringmax:10

Sự định nghĩa

Tiền tệ để chuyển đổi Từ

Kiểu tham số

stringmax:10

Sự định nghĩa

Tiền tệ để chuyển đổi sang

Kiểu tham số

string

Sự định nghĩa

Số tiền cần chuyển đổi sang tiền tệ từNếu có xu trong số tiền, hãy gửi chúng với dấu phân cách '.'
Ví dụ: 10.28

* - tham số bắt buộc

Ví dụ yêu cầu

curl https://api.cryptomus.com/v2/user-api/convert/ \
    -X POST \
    -H 'userId: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: fe99035f86fa436181717b302b95bacff1' \
    -H 'Content-Type: application/json' \
    -d '{
        "from": "BTC",
        "to": "USDT",
        "amount": "0.0001"
    }'
Sao chép

Phản ứng

Các thông số phản hồi

TênKiểu tham sốSự định nghĩa
order_idstringID của chuyển đổi
uuidstringUUID của lệnh chuyển đổi
convert_amount_fromstring|nullChuyển đổi số tiền từ
convert_amount_tostring|nullChuyển đổi số tiền thành
executed_amount_fromstring|nullSố tiền thực hiện từ
executed_amount_tostring|nullSố tiền thực hiện đến
convert_currency_fromstring|nullChuyển đổi tiền tệ từ
convert_currency_tostring|nullChuyển đổi tiền tệ sang
typestringKiểu enumCác tùy chọn có sẵn:• market• limit
statusstringTrạng thái enumCác tùy chọn có sẵn:• active• completed• partially_completed• cancelled• expired• failed
created_atstringNgày giờ tạo
current_ratestring|nullTỷ giá hiện tại
market_ratestring|nullGiá thị trường
limitstring|nullGiá trị giới hạn (chỉ khi loại giới hạn)
expires_atstringNgày giờ hết hạn giới hạn
completed_atstringNgày giờ khi đơn hàng hoàn tất (chỉ khi đơn hàng đã hoàn tất)

Kiểu tham số

string

Sự định nghĩa

ID của chuyển đổi

Kiểu tham số

string

Sự định nghĩa

UUID của lệnh chuyển đổi

Kiểu tham số

string|null

Sự định nghĩa

Chuyển đổi số tiền từ

Kiểu tham số

string|null

Sự định nghĩa

Chuyển đổi số tiền thành

Kiểu tham số

string|null

Sự định nghĩa

Số tiền thực hiện từ

Kiểu tham số

string|null

Sự định nghĩa

Số tiền thực hiện đến

Kiểu tham số

string|null

Sự định nghĩa

Chuyển đổi tiền tệ từ

Kiểu tham số

string|null

Sự định nghĩa

Chuyển đổi tiền tệ sang

Kiểu tham số

string

Sự định nghĩa

Kiểu enumCác tùy chọn có sẵn:- market- limit

Kiểu tham số

string

Sự định nghĩa

Trạng thái enumCác tùy chọn có sẵn:- active- completed- partially_completed- cancelled- expired- failed

Kiểu tham số

string

Sự định nghĩa

Ngày giờ tạo

Kiểu tham số

string|null

Sự định nghĩa

Tỷ giá hiện tại

Kiểu tham số

string|null

Sự định nghĩa

Giá thị trường

Kiểu tham số

string|null

Sự định nghĩa

Giá trị giới hạn (chỉ khi loại giới hạn)

Kiểu tham số

string

Sự định nghĩa

Ngày giờ hết hạn giới hạn

Kiểu tham số

string

Sự định nghĩa

Ngày giờ khi đơn hàng hoàn tất (chỉ khi đơn hàng đã hoàn tất)

Ví dụ phản hồi


1{
2  "state": 0,
3  "result": {
4    "order_id": "2d9bf426-98ef-448b-84c2-03cc1ec78feb",
5    "uuid": "740a39d1-2edd-4b4d-bf49-826caf324312",
6    "convert_amount_from": "10.000",
7    "convert_amount_to": "3.000",
8    "executed_amount_from": null,
9    "executed_amount_to": null,
10    "convert_currency_from": "USDT",
11    "convert_currency_to": "XMR",
12    "type": "market",
13    "status": "completed",
14    "created_at": "2024-07-11 , 18:06:04",
15    "current_rate": "100",
16    "market_rate": "100",
17    "completed_at": "2024-07-11 , 18:06:04"
18  }
19}
Sao chép