Get Rate History

This endpoint returns the rate history for the authorized PSMD rate actor. Each history record represents a rate insert or update made for the applicable fiat currency.

Endpoint

POSThttps://api.tylt.money/v2/prime-fiat/php/rate/history

Request Headers

First Tab

Name	Type	Example	Description
X-TLP-APIKEY	string	93ee3c5e133697251b5362bcf9cc8532476785t8768075616f58d88	Your Tylt API Key, used to identify your account in API requests.
X-TLP-SIGNATURE	string	d0afef3853dfc8489c8b9affa5825171fdd7y7685675e4966a05f66ed2b3eaf9462b3c9c0	HMAC SHA-256 signature generated using the API Secret Key to secure the request.

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.

Query Parameters

Parameters

Parameter	Type	Default	Description
currencySymbol	string	—	Filter rate history by fiat currency symbol. Example: PHP.
limit	number	50	Number of history records to return. Maximum value: 200.
offset	number	0	Pagination offset.

Code Snippet

JavaScript (Axios)

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

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

const query = {
  currencySymbol: "PHP",
  limit: "50",
  offset: "0"
};

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

axios.get(
  "https://api.tylt.money/v2/prime-fiat/php/rate/history",
  {
    params: query,
    headers: {
      "X-TLP-APIKEY": apiKey,
      "X-TLP-SIGNATURE": signature
    }
  }
)
  .then((response) => console.log(response.data))
  .catch((error) => console.error(error.response?.data || error));

Response

200

{
  "msg": "Rate history fetched successfully.",
  "data": [
    {
      "id": 10,
      "rateId": 1,
      "fiatCurrencySymbol": "PHP",
      "cryptoCurrencySymbol": "USDT",
      "usdtToFiatRate": 58,
      "fiatToUsdtRate": 0.017241379310344827,
      "action": "update",
      "createdAt": "2026-05-14T10:15:30Z"
    }
  ]
}

Response Fields

Field	Type	Description
id	number	Unique ID of the history record.
rateId	number	ID of the active rate record associated with the history entry.
fiatCurrencySymbol	string	Fiat currency symbol for which the rate was set.
cryptoCurrencySymbol	string	Crypto currency symbol used for conversion. Currently USDT.
usdtToFiatRate	number	Rate in 1 USDT = x fiatCurrency format.
fiatToUsdtRate	number	Derived rate in 1 fiatCurrency = x USDT format.
action	string	Indicates whether the history entry was created by an insert or update action. Possible values: insert, update.
createdAt	string	Timestamp when the history record was created.