> 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/trade-details.md).

# Trade Details

This API allows merchants to manually fetch the exact callback / webhook payload for a specific instance. The response contains the current trade, transaction, account, user, and settlement-related details for the selected instance.

**Endpoint**

<mark style="color:green;">**`GET`**</mark>`https://api.tylt.money/v2/prime-ntx/instance/{identifier}/trade-details`

| Parameter  |             Type | Required | Description                                                                                  |
| ---------- | ---------------: | -------: | -------------------------------------------------------------------------------------------- |
| identifier | string / integer |      Yes | The instance identifier. You may pass either the UUID `instanceId` or the numeric `tradeId`. |

**Example Request**

<mark style="color:green;">**`GET`**</mark>`https://api.tylt.money/v2/prime-ntx/instance/1563365/trade-details`

<mark style="color:green;">**`GET`**</mark>`https://api.tylt.money/v2/prime-ntx/instance/e12a29be-5725-41b5-9913-d783174f631b/trade-details`

{% hint style="warning" %}
We recommend using `instanceId` as the primary identifier. In some cases, an instance may not result in a trade, meaning a `tradeId` may not exist.
{% endhint %}

**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</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>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 instanceId = "ccacfd2d-d277-4938-b0b3-07d04cb10dbb";

// Use this payload when using instanceId in the URL
const signingPayload = JSON.stringify({
  instanceId: String(instanceId),
});

const signature = crypto
  .createHmac("sha256", apiSecret)
  .update(signingPayload)
  .digest("hex");

axios
  .get(`https://api.tylt.money/v2/prime-ntx/instance/${instanceId}/trade-details`, {
    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": "Trade details fetched successfully",
  "data": {
    "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
  }
}
```

{% endtab %}

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

| Field |   Type | Description                                                           |
| ----- | -----: | --------------------------------------------------------------------- |
| msg   | string | Response message.                                                     |
| data  | object | Contains the trade, transaction, account, user, and callback details. |

**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 current 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 | Current 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                                        |
| ----------------------------------- | ------------: | -------------------------------------------------- |
| accounts.network                    |        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 or pay-out.       |
| 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.                            |
| {% endtab %}                        |               |                                                    |
| {% endtabs %}                       |               |                                                    |