Guavy Logo GUAVY
Trades Get Recent Sells
GET
·
/api/v1/trades/get-recent-sells

Get Recent Sells

This endpoint returns recent sells made by the Guavy trade simulator.

Attributes

limit
integer
Specifies the maximum number of instruments to return (default is 10).
skip
integer
Specifies the number of results to skip (default is 0).
strategy
string
Specifies a risk profile to filter scorecards for. Either 'aggressive' or 'conservative'. Default is 'Any'.

API Request

Example Request with cURL

curl \
--request GET \
--url     'https://data.guavy.com/api/v1/trades/get-recent-sells?limit=<integer>&skip=<integer>&strategy=<string>' \
--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-recent-sells?limit=2&skip=0&strategy=Any

{
  "trades": [
    {
      "action": "Sell",
      "entry_price": 454.52282316309953,
      "exit_price": 448.6291408964165,
      "exit_reason": "TrendChange",
      "highest_price": 454.52282316309953,
      "lowest_price": 454.52282316309953,
      "profit": -5.893682266683015,
      "profit_percent": -1.3,
      "sell_date": "2026-04-26",
      "strategy": "conservative",
      "symbol": "BCH"
    },
    {
      "action": "Sell",
      "entry_price": 0.5532014604373701,
      "exit_price": 0.5393714239264358,
      "exit_reason": "StopLoss",
      "highest_price": 0.5532014604373701,
      "lowest_price": 0.5532014604373701,
      "profit": -0.013830036510934283,
      "profit_percent": -2.5,
      "sell_date": "2026-04-26",
      "strategy": "conservative",
      "symbol": "MASK"
    }
  ]
}

Response Object

trades
array[object]
Array of selling trade history objects, with the following keys:
action
string
The trade action taken (Sell).
entry_price
float
The price of the instrument when the trade was entered.
exit_price
float
The price of the instrument at the sell date.
exit_reason
string
The reason for exiting the trade.
highest_price
float
The highest price during the trade.
lowest_price
float
The lowest price during the trade.
profit
float
The profit of the trade.
profit_percent
float
The profit percentage of the trade.
sell_date
string
The date of the sell and exiting of the trade.
strategy
string
The risk profile used for the trade. Can be 'aggressive' or 'conservative'.
symbol
string
The symbol representing the instrument object.

Token Costs

Each API call consumes tokens from your monthly budget. Endpoints that return richer or deeper data cost more tokens. Historical endpoints scale with the amount of data requested.

Endpoint Token Cost
GET /api/v1/ping 1
GET /api/v1/instruments/list-symbols 1
GET /api/v1/instruments/search-instruments/:query 2
GET /api/v1/instruments/get-detail/:symbol 5
GET /api/v1/instruments/scorecard/:symbol 10
GET /api/v1/newsroom/get-market-summary 3
GET /api/v1/newsroom/get-article/:id 3
GET /api/v1/newsroom/get-recent-briefs/:symbol 3 – 8 (scales with limit)
GET /api/v1/newsroom/search-briefs/:symbol 3 – 8 (scales with limit)
GET /api/v1/newsroom/get-instrument-analysis/:symbol 10
GET /api/v1/trades/get-recent-buys 3
GET /api/v1/trades/get-recent-sells 3
GET /api/v1/trades/get-recommendations 5
GET /api/v1/trades/get-current-action/:symbol/:strategy 5
GET /api/v1/trades/get-trend-history/:symbol/:limit 5 – 15 (scales with limit)
GET /api/v1/trades/get-backtest-history/:symbol/:strategy 8 – 20 (scales with years)
GET /api/v1/trades/get-backtest-summary/:symbol/:strategy 8 – 20 (scales with years)
GET /api/v1/sentiment/get-sentiment-history/:symbol 3 – 12 (scales with limit)
GET /api/v1/technical-analysis/get-price-history/:symbol 5
GET /api/v1/technical-analysis/get-indicators/:symbol 8

Account Limits

Each plan includes a monthly token budget: 3,000 for Sandbox, 250,000 for Quant, and 2,000,000 for Commercial. You can top up at any time with a one-time token pack — unused tokens roll over every month. If you exceed your budget, the API returns a 403 until the next reset or until you purchase more tokens.

Connection Limits

The Guavy API has a limit of 10 simultaneous connections and a 120-second timeout per request. We recommend caching responses that don't change frequently to reduce token consumption and improve performance.

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

© 2026 Guavy Inc. All rights reserved.