Guavy Logo GUAVY
Trades Get Trend History
GET
·
/api/v1/trades/get-trend-history

Get Trend History

This endpoint returns timeseries trend data for a given instrument.

Attributes

symbol
string
Required
The symbol of the instrument to fetch trend history for.
limit
integer
Required
The maximum number of days of time series trend data to return.

API Request

Example Request with cURL

curl \
--request GET \
--url     'https://data.guavy.com/api/v1/trades/get-trend-history/<symbol>/<limit>' \
--header 'Authorization: Bearer YOUR-GUAVY-ACCESS-TOKEN' \
--header 'Content-Type: application/json'

This request format works across all modern HTTP clients, including Python requests, JavaScript fetch, and other programming language libraries.

Example Response for /api/v1/trades/get-trend-history/btc/4

{
  "trends": [
    {
      "date": "2025-12-12",
      "price": 92330.41439021764,
      "strength": "Weak",
      "timestamp": 1765548000000,
      "trend": "Up"
    },
    {
      "date": "2025-12-11",
      "price": 90097.57956273256,
      "strength": "Weak",
      "timestamp": 1765461600000,
      "trend": "Up"
    },
    {
      "date": "2025-12-10",
      "price": 92096.45876810091,
      "strength": "Moderate",
      "timestamp": 1765375200000,
      "trend": "Up"
    },
    {
      "date": "2025-12-09",
      "price": 90418.75088187352,
      "strength": "Moderate",
      "timestamp": 1765288800000,
      "trend": "Up"
    }
  ]
}

Response Object

trends
array[object]
Array of trend history objects, with the following keys:
date
string
Human-readable date string formatted from the timestamp.
price
integer
The price of the cryptocurrency at the start of the trend.
strength
string
The strength of the trend e.g. Moderate, Solid, Strong, or Weak
timestamp
integer
UNIX timestamp (in milliseconds) representing when this data was collected.
trend
string
The trend of the cryptocurrency action e.g. Up, Down, or Neutral.

API Limits

The Guavy API has a limit of 10 simultaneous connections. You'll receive a 429 error if you reach the limit. At exceptionally high volumes, you may receive an HTTP 429 or 403 without a JSON body.

We recommend that you cache frequently accessed values that do not change often in your application's data store. This will prevent your application from bumping up against the throttling limitations and will likely provide faster access to that data.

Account Limits

Your Guavy account will typically have a licensed limit of at least 100,000 API calls per month. In addition, there is a limit of 10,000 API calls per day. If you reach these limits, you will receive a 429 error.

Connection Timeouts

The Guavy API has a 120-second timeout on API calls. You may see this type of timeout after you've made a network socket connection and are already sending and receiving data. Response times are dependent on the complexity of your request and the general load across Guavy. Some endpoints in the Guavy API return values that are large and slow to calculate.

Was this helpful?
Feedback option #{picture.id}
Feedback option #{picture.id}
Feedback option #{picture.id}
Feedback option #{picture.id}

© 2025 Guavy Inc. All rights reserved.