Skip to main content

​
Endpoint

GET /client-api/hti/history

​
Headers

X-API-Code: <YOUR_API_CODE>
Accept: application/json

​
Query Parameters

NameTypeRequiredDescription
limitintegerNoNumber of items to return. Supported range: 1 to 50
Call the history endpoint:
  • When your application starts
  • After reconnecting from a network interruption
  • When you want the latest 10 or 20 matching ideas on demand

​
cURL Example

curl -X GET "http://your-hti-environment:3500/client-api/hti/history?limit=10" \
  -H "X-API-Code: <YOUR_API_CODE>" \
  -H "Accept: application/json"

​
Example Response

{
  "status": "ok",
  "profile": {
    "account_name": "NEW ACCOUNT 03",
    "api_code": "140b17o794rA680-1Ba16t168C566",
    "validity_type": "unlimited",
    "valid_until": null,
    "request_limit_per_minute": 60,
    "filters": {
      "asset_classes": [],
      "timeframes": [],
      "instruments": [],
      "prefixes": [],
      "sides": []
    },
    "authenticated_at": "2026-04-22T13:24:00Z"
  },
  "count": 10,
  "limit": 10,
  "ideas": [
    {
      "ASSET_CLASS": "ETFS",
      "CREATION_TIME": "2026-04-22 09:15:05 EST",
      "SIDE": "Sell",
      "INSTRUMENT": "GLD",
      "LAST_UPDATE": "2026-04-22 09:17:47 EST",
      "CONFIDENCE": "90%",
      "ESTIMATED_PL": "+1.15%",
      "PREFIX": "HTI12",
      "EXPIRATION_TIME": "2026-04-22 10:17:47 EST",
      "STOP_LOSS": 448.0495,
      "DESCRIPTION": "Oversold conditions for GLD introduce significant risk for a SELL LIMIT despite the strong mechanical signal.",
      "OPEN_ORDER_TYPE": "SELL LIMIT",
      "ID": "HTI12_TB_GLD_M15_20260422_090000",
      "TIMEFRAME": "M15",
      "PRICE": 437.9699,
      "TAKE_PROFIT": 432.9301,
      "document_id": "HTI12_TB_GLD_M15_20260422_090000",
      "idea_id": "HTI12_TB_GLD_M15_20260422_090000"
    }
  ],
  "served_at": "2026-04-22T13:24:00Z"
}

​
Notes

  • Results are already filtered by your assigned API profile
  • You cannot override those permissions from the client
  • The response may include convenience fields such as document_id and idea_id
  • The newest items are returned first

​
Best Practice

Use history as your startup snapshot and then keep the Real-Time Stream open for live delivery.