> For the complete documentation index, see [llms.txt](https://docs.tylt.money/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tylt.money/tylt-crossramp-fiat-crypto-solutions/brazil-brl/transactions-report.md).

# Transactions Report

This API allows merchants to fetch all PIX cross-ramp transactions for a specific calendar date.

**Endpoint**

<mark style="color:green;">**`GET`**</mark>`https://api.tylt.money/v2/prime-ntx/transactions/report?date={yyyy-mm-dd}`

**Example Request**

<mark style="color:green;">**`GET`**</mark>`https://api.tylt.money/v2/prime-ntx/transactions/report?date=2026-07-04`

OR

<mark style="color:green;">**`GET`**</mark>`https://api.tylt.money/v2/prime-ntx/transactions/report?hours=12`

**Request Parameters**

<table><thead><tr><th>Parameter</th><th align="right">Type</th><th width="154" align="right">Required</th><th>Description</th></tr></thead><tbody><tr><td>date</td><td align="right">string</td><td align="right">Yes (if no <code>hours</code>)</td><td>Calendar date for which the report is required. Format: YYYY-MM-DD. The backend maps this date from 00:00:00Z to 23:59:59Z.</td></tr><tr><td>hours</td><td align="right">integer</td><td align="right">Yes (if no <code>date</code>)</td><td>Number of past hours to fetch transactions for. Must be an integer between 1 and 24.</td></tr><tr><td>page</td><td align="right">integer</td><td align="right">No</td><td>Pagination page number. Defaults to 1.</td></tr><tr><td>limit</td><td align="right">integer</td><td align="right">No</td><td>Number of records to return per page. Defaults to 20. Maximum allowed value is 50.</td></tr></tbody></table>

**Request Headers**

{% tabs %}
{% tab title="Headers" %}

<table data-full-width="true"><thead><tr><th width="182">Name</th><th width="79">Type</th><th width="167">Example</th><th>Description</th></tr></thead><tbody><tr><td>X-TLP-APIKEY</td><td>string</td><td>93ee3c5e133697251b5362bcf9cc8532476785t8768075616f58d88</td><td>Your Tylt API Key, used to identify your account in API requests.</td></tr><tr><td>X-TLP-SIGNATURE</td><td>string</td><td>d0afef3853dfc8489c8b9affa5825171fdd7y7685675e4966a05f66ed2b3eaf9462b3c9c0</td><td>HMAC SHA-256 signature generated using the API Secret Key to secure the request.</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
When using the API, ensure to include your API Key and generate the signature for the request payload using your API Secret. The tables provided above contain example values for illustration purposes only. Please refer to the code snippets for detailed instructions on how to sign the request and generate the signature properly.
{% endhint %}

**Code Snippet**

{% tabs %}
{% tab title="Node JS" %}

```javascript
const axios = require("axios");
const crypto = require("crypto");

const apiKey = "your-api-key";
const apiSecret = "your-api-secret";

const params = {
  date: "2026-07-04",
  page: "1",
  limit: "50",
};

// 1. Sort keys to keep the signing payload consistent
const sortedParams = Object.keys(params)
  .sort()
  .reduce((acc, key) => {
    acc[key] = String(params[key]);
    return acc;
  }, {});

// 2. Stringify the sorted object
const signingPayload = JSON.stringify(sortedParams);

// 3. Generate the HMAC signature
const signature = crypto
  .createHmac("sha256", apiSecret)
  .update(signingPayload)
  .digest("hex");

axios
  .get("https://api.tylt.money/v2/prime-ntx/transactions/report", {
    // CRITICAL: We pass the exactly sorted parameters into Axios here
    // so the URL generated natively matches the hash order.
    params: sortedParams,
    headers: {
      "X-TLP-APIKEY": apiKey,
      "X-TLP-SIGNATURE": signature,
    },
  })
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.error(error.response?.data || error.message);
  });

```

{% endtab %}
{% endtabs %}

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
  "msg": "Transactions fetched successfully",
  "data": {
    "list": [
      {
        "trade": {
          "event": {
            "id": 4,
            "deadline": "2026-06-05T11:46:33Z",
            "description": "Seller Acknowledges Payment Receipt. Trade Completed."
          },
          "pixCode": "00020101021226850014br.gov.bcb.pix2563qrcode.brzip.com.br/pix/qr/db944974-de9b-4f54-a251-7d80a0fec7515204000053039865802BR5925GESTAO EMPRESARIAL CIOTTA6009SAO PAULO62070503***6304C403",
          "tradeId": 1197457,
          "qrString": "data:image/png;base64,...",
          "createdAt": "2026-06-05T11:35:18Z",
          "updatedAt": "2026-06-05T11:37:30Z",
          "isBuyTrade": 1,
          "fiatCurrency": {
            "name": "Brazilian Real",
            "symbol": "BRL"
          },
          "priceDetails": {
            "price": 0.1968,
            "amount": 0.39,
            "paymentAmount": 2
          },
          "cryptoCurrency": {
            "name": "Tether",
            "symbol": "USDT"
          }
        },
        "transaction": {
          "amount": 0.34,
          "status": "Completed",
          "isFinal": 1,
          "orderId": "af36d51c-f826-45fc-a510-4dd04a16795e",
          "createdAt": "2026-06-05T11:37:24Z",
          "isDebited": 1,
          "updatedAt": "2026-06-05T11:37:33Z",
          "merchantOrderId": "gaming-test-1780659318730"
        },
        "accounts": {
          "network": "ETH",
          "MDR_Rate": 0.75,
          "localCurrency": "BRL",
          "transactionHash": null,
          "transactionType": "pay-in",
          "merchantAccountDebited": null,
          "merchantAccountCredited": 0.34,
          "amountPaidInLocalCurrency": 2,
          "conversionRate": 0.1968,
          "amountPaidInCryptoCurrency": 10.16260162601626,
          "cryptoCurrencySymbol": "USDT"
        },
        "user": {
          "name": "John Doe"
        },
        "callBackUrl": "https://api.tylt.money/common/postback",
        "insufficientBalance": 0,
        "manualSettlement": 0,
        "instanceExpired": 1
      }
    ],
    "pagination": {
      "total": 481,
      "current_page": 1,
      "limit": 50,
      "total_pages": 10
    }
  }
}
```

{% endtab %}

{% tab title="Response Fields" %}
**Response Parameters**

| Field           |   Type | Description                                           |
| --------------- | -----: | ----------------------------------------------------- |
| msg             | string | Response message.                                     |
| data            | object | Contains the transaction list and pagination details. |
| data.list       |  array | List of transactions for the selected date.           |
| data.pagination | object | Pagination details for the report.                    |

**Trade Object**

| Field                            |    Type | Description                                 |
| -------------------------------- | ------: | ------------------------------------------- |
| trade.event.id                   | integer | Event ID of the trade.                      |
| trade.event.deadline             |  string | Trade deadline timestamp.                   |
| trade.event.description          |  string | Description of the trade event.             |
| trade.pixCode                    |  string | PIX payment code.                           |
| trade.tradeId                    | integer | Unique Tylt trade ID.                       |
| trade.qrString                   |  string | Base64 QR image string, where available.    |
| trade.createdAt                  |  string | Trade creation timestamp.                   |
| trade.updatedAt                  |  string | Last trade update timestamp.                |
| trade.isBuyTrade                 | integer | Indicates whether the trade is a buy trade. |
| trade.fiatCurrency.name          |  string | Fiat currency name.                         |
| trade.fiatCurrency.symbol        |  string | Fiat currency symbol.                       |
| trade.priceDetails.price         |  number | Conversion price used for the trade.        |
| trade.priceDetails.amount        |  number | Crypto amount calculated for the trade.     |
| trade.priceDetails.paymentAmount |  number | Fiat payment amount.                        |
| trade.cryptoCurrency.name        |  string | Crypto currency name.                       |
| trade.cryptoCurrency.symbol      |  string | Crypto currency symbol.                     |

**Transaction Object**

| Field                       |    Type | Description                                    |
| --------------------------- | ------: | ---------------------------------------------- |
| transaction.amount          |  number | Transaction amount credited or debited.        |
| transaction.status          |  string | Transaction status.                            |
| transaction.isFinal         | integer | Indicates whether the transaction is final.    |
| transaction.orderId         |  string | Tylt order ID.                                 |
| transaction.createdAt       |  string | Transaction creation timestamp.                |
| transaction.updatedAt       |  string | Last transaction update timestamp.             |
| transaction.isDebited       | integer | Indicates whether the transaction was debited. |
| transaction.merchantOrderId |  string | Merchant-provided order ID.                    |

**Accounts Object**

| Field                               |          Type | Description                                        |
| ----------------------------------- | ------------: | -------------------------------------------------- |
| <p></p><p>accounts.network</p>      |        string | Blockchain network.                                |
| accounts.MDR\_Rate                  |        number | Merchant discount rate applied to the transaction. |
| accounts.localCurrency              |        string | Local fiat currency.                               |
| accounts.transactionHash            | string / null | Blockchain transaction hash, where applicable.     |
| accounts.transactionType            |        string | Transaction type, such as pay-in.                  |
| accounts.merchantAccountDebited     | number / null | Amount debited from the merchant account.          |
| accounts.merchantAccountCredited    | number / null | Amount credited to the merchant account.           |
| accounts.amountPaidInLocalCurrency  |        number | Amount paid by the user in local fiat currency.    |
| accounts.conversionRate             |        number | Conversion rate used for the transaction.          |
| accounts.amountPaidInCryptoCurrency |        number | Crypto equivalent of the local currency amount.    |
| accounts.cryptoCurrencySymbol       |        string | Crypto currency symbol.                            |

**Pagination Object**

| Field                    |    Type | Description                            |
| ------------------------ | ------: | -------------------------------------- |
| pagination.total         | integer | Total number of matching transactions. |
| pagination.current\_page | integer | Current page number.                   |
| pagination.limit         | integer | Number of records returned per page.   |
| pagination.total\_pages  | integer | Total number of pages available.       |
| {% endtab %}             |         |                                        |
| {% endtabs %}            |         |                                        |