Skip to main content

​
Overview

Each idea object contains market context, execution levels, and metadata about when the idea was generated and updated.

​
Common Fields

FieldTypeDescription
IDstringSource idea identifier
idea_idstringAPI-friendly identifier, usually the same as ID
document_idstringFirestore document identifier
PREFIXstringStrategy or feed prefix such as HTI11 or HTI12
ASSET_CLASSstringAsset category such as US EQUITIES, FOREX, or ETFS
INSTRUMENTstringSymbol or instrument name
TIMEFRAMEstringTimeframe such as M5, M15, or H1
SIDEstringTrade direction, for example Buy or Sell
OPEN_ORDER_TYPEstringExecution style such as BUY LIMIT or SELL LIMIT
PRICEnumberSuggested entry price
TAKE_PROFITnumberTake profit level
STOP_LOSSnumberStop loss level
CONFIDENCEstringConfidence score such as 90%
ESTIMATED_PLstringEstimated profit/loss expression such as +0.63%
DESCRIPTIONstringHuman-readable explanation of the idea
CREATION_TIMEstringOriginal idea creation time
LAST_UPDATEstringLatest update time for the idea
EXPIRATION_TIMEstringIntended validity window for the idea

​
Example Idea

{
  "ASSET_CLASS": "US EQUITIES",
  "CONFIDENCE": "90%",
  "CREATION_TIME": "2026-04-22 04:35:15 EST",
  "DESCRIPTION": "General market caution due to geopolitical tensions slightly reduces the strength of the mechanical BUY signal.",
  "ESTIMATED_PL": "+0.63%",
  "EXPIRATION_TIME": "2026-04-22 05:37:59 EST",
  "ID": "HTI11_TB_AMD_M5_20260422_043000",
  "INSTRUMENT": "AMD",
  "LAST_UPDATE": "2026-04-22 04:37:59 EST",
  "OPEN_ORDER_TYPE": "BUY LIMIT",
  "PREFIX": "HTI11",
  "PRICE": 289.38285,
  "SIDE": "Buy",
  "STOP_LOSS": 285.71425,
  "TAKE_PROFIT": 291.21715,
  "TIMEFRAME": "M5",
  "document_id": "HTI11_TB_AMD_M5_20260422_043000",
  "idea_id": "HTI11_TB_AMD_M5_20260422_043000"
}

​
Parsing Notes

  • Some fields are numeric and some are strings
  • Time values are returned as strings in the current API payload
  • DESCRIPTION can span multiple lines
  • New convenience fields may be added over time without changing the core idea meaning

​
Best Practice

Use idea_id together with LAST_UPDATE when deduplicating or tracking idea refreshes in your own client.