交易

get
https://api.cryptomus.com/v2/user-api/transaction/list
复制

要求

查询参数

姓名定义
date_from按创建日期过滤（格式：“YYYY-MM-DD H:mm:ss”）
date_to按创建日期过滤，至（格式：“YYYY-MM-DD H:mm:ss”）
type交易类型

定义

按创建日期过滤（格式：“YYYY-MM-DD H:mm:ss”）

定义

按创建日期过滤，至（格式：“YYYY-MM-DD H:mm:ss”）

定义

交易类型

请求示例


curl https://api.cryptomus.com/v2/user-api/transaction/list \
    -X POST \
    -H 'userId: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: fe99035f86fa436181717b302b95bacff1' \
    -H 'Content-Type: application/json' \
    -d '{
    "date_from": "2023-05-16 00:00:00"
    "date_to": "2023-05-16 23:59:59"
    "type": "payment"
  }'
复制

类型

请求类型

姓名定义
payment支付交易
payout支付交易
transfer从/到商业钱包交易转账

定义

支付交易

定义

支付交易

定义

从/到商业钱包交易转账

回复

响应参数

姓名定义
items 结构
paginate 结构

定义

结构

定义

结构

项目响应参数

姓名定义
uuid交易UUID
type交易类型
status 结构
amount数量
amount_equivalent等值金额
currency_equivalent货币等值金额（您个人账户中设置的货币）
currency货币代码
comment评论
network区块链网络代码
address付款钱包地址
txid交易哈希
created_at交易时间

定义

交易UUID

定义

交易类型

定义

结构

定义

数量

定义

等值金额

定义

货币等值金额（您个人账户中设置的货币）

定义

货币代码

定义

评论

定义

区块链网络代码

定义

付款钱包地址

定义

交易哈希

定义

交易时间

对响应参数进行分页

姓名定义
count当前页面上的项目数
hasPages是否有足够的元素分为多个页面（true / false）
nextCursor下一页的光标
previousCursor前面页面的光标
perPage每个页面的最大元素数量

定义

当前页面上的项目数

定义

是否有足够的元素分为多个页面（true / false）

定义

下一页的光标

定义

前面页面的光标

定义

每个页面的最大元素数量

状态响应参数

姓名定义
check等待交易出现在区块链上
paid交易成功
fail交易错误
cancel交易已取消
locked由于AML计划，资金被锁定

定义

等待交易出现在区块链上

定义

交易成功

定义

交易错误

定义

交易已取消

定义

由于AML计划，资金被锁定

要获取下一页/上一页的记录，请在查询参数中指定下一页/上一页游标哈希 (?cursor=<nextCursorHash>)

例子：


curl https://api.cryptomus.com/v2/user-api/transaction/list?cursor=eyJpZCI6MjEyLCJ fcG9pbnRzVzVG9OZhXh0SXRlbXMiOnRydWV9 \
    -X POST \
    -H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: f80fa426a89eb62bd53997326865d850' \
    -H 'Content-Type: application/json' \
    -d '{}'
复制

响应示例


1{
2  "state": 0,
3  "result": {
4    "items": [
5      {
6        "uuid": "3a3efbe5-4835-48f3-95c0-7b63e2c8a0b6",
7        "type": "transfer",
8        "status": "paid",
9        "created_at": "2022-07-22T15:11:46.000000Z",
10        "amount": "10.00",
11        "amount_equivalent": "10.1679",
12        "currency_equivalent": "USD",
13        "currency": "USDT",
14        "network": null,
15        "txid": null,
16        "address": null,
17        "comment": null
18      },
19      {
20        "uuid": "d4953ea1-6f55-46f1-b1c9-f72c04badc45",
21        "type": "payout",
22        "status": "paid",
23        "created_at": "2022-09-01T14:46:44.000000Z",
24        "amount": "10.00",
25        "amount_equivalent": "10.1679",
26        "currency_equivalent": "USD",
27        "currency": "USDT",
28        "network": "tron",
29        "txid": null,
30        "address": "TSV1JBNzp71tucPrEsRPG5iLD1DkftzWzF",
31        "comment": null
32      },
33      {
34        "uuid": "690f745a-6b0c-42e1-a6ee-0de34485cab7",
35        "type": "payment",
36        "status": "fail",
37        "created_at": "2022-09-02T08:32:03.000000Z",
38        "amount": "2.00",
39        "amount_equivalent": "10.63359",
40        "currency_equivalent": "USD",
41        "currency": "USDT",
42        "network": "tron",
43        "txid": null,
44        "address": "TSV1JBNzp71tucPrEsRPG5iLD1DkftzWzF",
45        "comment": null
46      }
47    ],
48    "paginate": {
49      "count": 3,
50      "hasPages": true,
51      "nextCursor": "eyJpdiI6IlFIZnd5Lzd0VUN3TGtUNUF6ckV5TEE9PSIsInZhbHVlIjoiUHcvZm1rWmRqdDVKL25NMW5EVEQ1OW9JS0NiSjhJcHd1byt5SGhmVG95UjhGaUlCa3djT1ZSOU5Lc29Id3B3bC80T0VBSnhhZEZBWk1yZUN5RTByN2pKK0dNVUZ0QnFlcThwMU93d0NSR2pXMHJOQWZIa3N6cStmT0YxOG9VVDJyT1Q2NmVhbU9JU1N6cTJsM3JLTitRPT0iLCJtYWMiOiI2M2E4OWVmZTk3MDNjYzUwNjY0ZWY4ZjcxMjUyOGUzMmI4NzNkNWU4YzNlYmUxNmNmMThhM2JhN2RjNTkyYjgxIiwidGFnIjoiIn0=",
52      "previousCursor": null,
53      "perPage": 15
54    }
55  }
56}
57
复制