Транзакции

Этот эндпоинт используется для получения списка всех транзакций, связанных с юнитом, клиентом или системой в целом. Запрос позволяет фильтровать транзакции по различным параметрам — таким как статус, тип, сеть, валюта, даты, адреса и т.д.

💡 Зачем нужен: Этот запрос необходим для аналитики, отслеживания поступлений и выплат, контроля статусов, а также для интеграции в финансовые панели или CRM, где требуется видеть историю всех операций.

GET/v1/transactions

Headers

Example of x-api-key

74364121-2fb8-4e06-b093-7b1f83f0d5a8

Please note: the x-api-key is unique and provided to each client individually by Monocrypt.

Query Parameters 📝

Фильтры передаются в JSON в формате, но под капотом это превращается в строку query-параметров.

Пример JSON фильтра:

{
  "and": [
    { "or": [{ "txId": { "iLike": "%5fe07d8de..." } }] },
    { "or": [{ "currency": { "eq": "USDT" } }, { "currency": { "eq": "USDC" } }] },
    { "or": [{ "network": { "eq": "TRC20" } }, { "network": { "eq": "ERC20" } }] },
    { "or": [{ "status": { "eq": "completed" } }] }
  ]
}

---

Как это выглядит в браузере / URL 🌐

При отправке GET-запроса JSON конвертируется в URL-encoded строку:

paging[limit]=100&
paging[offset]=0&
sorting[0][field]=createdAt&
sorting[0][direction]=DESC&
filter[and][0][or][0][txId][iLike]=%255fe07d8de...
&filter[and][1][or][0][currency][eq]=USDT
&filter[and][1][or][1][currency][eq]=USDC
&filter[and][2][or][0][network][eq]=TRC20
&filter[and][2][or][1][network][eq]=ERC20
&filter[and][3][or][0][status][eq]=completed

💡 Важно:

• Все вложенные объекты and / or превращаются в ключи с квадратными скобками.

• %25 — это кодировка символа %, которая используется для iLike фильтров.

• Таким образом, в браузере или через Axios / Postman фильтр отправляется как строка, а не как JSON.

Пример запроса через Axios ⚡

const response = await axios.get('/v1/clients', {
  headers: { 'x-api-key': 'YOUR_API_KEY' },
  params: {
    paging: { limit: 100, offset: 0 },
    sorting: [{ field: 'createdAt', direction: 'DESC' }],
    filter: {
      and: [
        { or: [{ txId: { iLike: "%5fe07d8de..." } }] },
        { or: [{ currency: { eq: "USDT" } }, { currency: { eq: "USDC" } }] },
        { or: [{ network: { eq: "TRC20" } }, { network: { eq: "ERC20" } }] },
        { or: [{ status: { eq: "completed" } }] }
      ]
    }
  }
});

---

Особенности ⚡

• Запрос поддерживает фильтрацию, пагинацию и сортировку.

• Для передачи сложных условий используйте and / or комбинации.

• Поля фильтров должны соответствовать сущности клиента и его кошельков.

---

Response

[
   {
      "id":284191,
      "createdAt":"2025-05-20T08:28:01.599Z",
      "updatedAt":"2025-05-20T08:28:01.655Z",
      "amount":"5310.596903",
      "availableAmount":"5257.316709",
      "refillFee":null,
      "paymentOrderId":null,
      "externalPaymentOrderId":null,
      "currency":"USDC",
      "network":"ERC20",
      "type":"REFILL",
      "status":"completed",
      "txId":"",
      "addressTo":"",
      "addressFrom":"",
      "riskScore":0,
      "direction":"payin",
      "origin":"outside_our_topup",
      "confirmations":12,
      "payload":{},
      "externalId":19924,
      "manager":null,
      "clientId":15029,
      "unitId":58,
      "invoiceId":null,
      "exchangeId":null,
      "nativeRate":"0.0003957613954547",
      "usdtRate":"0.9997",
      "annotation":null,
      "subId":null,
      "errorText":null,
      "change":null,
      "remainingBalance":"42713.931612",
      "massPayoutId":null,
      "client":{
         "id":15029,
         "createdAt":"2025-04-23T14:42:08.288Z",
         "updatedAt":"2025-04-23T14:42:08.288Z",
         "clientId":15029,
         "uuid":"5a438a82-d267-41a5-b60c-30cdf745ccc3",
         "email":"[email protected]",
         "name":"PLcbdefbafa",
         "rootUnitId":4,
         "unitId":58,
         "isExternalParam":false,
         "wallets":[
            
         ]
      },
      "category":{
         "id":1,
         "createdAt":"2023-08-18T10:49:34.615Z",
         "updatedAt":"2023-08-18T10:49:34.615Z",
         "name":"Not Assigned",
         "color":null,
         "description":null,
         "group":{
            "id":1,
            "createdAt":"2023-08-18T10:49:34.615Z",
            "updatedAt":"2023-08-18T10:49:34.615Z",
            "name":"Not Assigned",
            "rootUnitId":null,
            "color":null,
            "description":null
         }
      },
      "unit":{
         "id":58,
         "createdAt":"2024-12-16T10:52:56.455Z",
         "updatedAt":"2025-02-25T00:43:57.414Z",
         "uuid":"68ef436c-a070-4e4f-b028-8457cad9f5fa",
         "name":"Tyrion Capital",
         "rootUnitId":4,
         "parentId":8,
         "adminIds":[
            17,
            18,
            5,
            38
         ],
         "description":null,
         "isActive":true,
         "logo":null
      },
      "invoice":null,
      "exchange":null,
      "totalFee":"53.280194",
      "walletName":""
   }
]

---