トランザクション

post https://api.cryptomus.com/v2/user-api/transaction/list コピー

リクエスト

クエリパラメーター

名前パラメータータイプ意味
date_fromstring作成日によるフィルタリング (形式: "YYYY-MM-DD H:mm:ss")
date_tostring作成日によるフィルタリング (形式: "YYYY-MM-DD H:mm:ss")
typestring取引タイプ

パラメータータイプ

string

意味

作成日によるフィルタリング (形式: "YYYY-MM-DD H:mm:ss")

パラメータータイプ

string

意味

作成日によるフィルタリング (形式: "YYYY-MM-DD H:mm:ss")

パラメータータイプ

string

意味

取引タイプ

リクエスト例


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ビジネスウォレット間のトランザクションの送金

意味

支払い取引

意味

支払い取引

意味

ビジネスウォレット間のトランザクションの送金

応答

応答パラメーター

名前パラメータータイプ意味
itemsarray 構造
paginateobject 構造

パラメータータイプ

array

意味

構造

パラメータータイプ

object

意味

構造

項目応答パラメータ

名前パラメータータイプ意味
uuidstringトランザクションUUID
typestring取引タイプ
statusstring|null 構造
created_atstringトランザクション時間
amountstring額
amount_equivalentstring|null相当額
currency_equivalentstring|null通貨相当額(個人アカウントに設定されている通貨)
currencystring通貨コード
networkstring|nullブロックチェーンネットワークコード
txidstring|nullトランザクションハッシュ
addressstring|null支払いのためのウォレットアドレス
commentstring|null解説

パラメータータイプ

string

意味

トランザクションUUID

パラメータータイプ

string

意味

取引タイプ

パラメータータイプ

string|null

意味

構造

パラメータータイプ

string

意味

トランザクション時間

パラメータータイプ

string

意味

額

パラメータータイプ

string|null

意味

相当額

パラメータータイプ

string|null

意味

通貨相当額(個人アカウントに設定されている通貨)

パラメータータイプ

string

意味

通貨コード

パラメータータイプ

string|null

意味

ブロックチェーンネットワークコード

パラメータータイプ

string|null

意味

トランザクションハッシュ

パラメータータイプ

string|null

意味

支払いのためのウォレットアドレス

パラメータータイプ

string|null

意味

解説

ページネーション応答パラメータ

名前パラメータータイプ意味
countinteger現在のページのアイテムの数
hasPagesboolean複数のページに分割するのに十分な要素があるかどうか(true / false)
nextCursorstring|null次のページからカーソル
previousCursorstring|null前のページからカーソル
perPageintegerページあたりの最大要素数

パラメータータイプ

integer

意味

現在のページのアイテムの数

パラメータータイプ

boolean

意味

複数のページに分割するのに十分な要素があるかどうか(true / false)

パラメータータイプ

string|null

意味

次のページからカーソル

パラメータータイプ

string|null

意味

前のページからカーソル

パラメータータイプ

integer

意味

ページあたりの最大要素数

ステータス応答パラメータ

名前意味
checkトランザクションがブロックチェーンに現れるのを待っています
paid取引は成功しました
failトランザクションエラー
cancel取引がキャンセルされました
lockedAMLプログラムにより、資金がロックされています

意味

トランザクションがブロックチェーンに現れるのを待っています

意味

取引は成功しました

意味

トランザクションエラー

意味

取引がキャンセルされました

意味

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      
コピー