> ## Documentation Index > Fetch the complete documentation index at: https://api.alphainsider.com/llms.txt > Use this file to discover all available pages before exploring further. # getTimelines > Get timeline events. ## OpenAPI ````yaml /openapi.yaml get /getTimelines openapi: 3.1.0 info: title: AlphaInsider version: '1.0' description: >- The official API and websocket documentation for [AlphaInsider.com](https://alphainsider.com/) servers: - url: https://alphainsider.com/api security: [] tags: - name: Introduction - name: Authentication - name: Users - name: Strategies - name: Subscriptions - name: Payments - name: Withdrawals - name: Timelines - name: Stocks - name: Trades - name: Webhooks - name: Bots - name: Websockets paths: /getTimelines: get: tags: - Timelines summary: getTimelines description: Get timeline events. operationId: getTimelines parameters: - $ref: '#/components/parameters/optional_api_token' - name: timeline_id[] in: query required: true schema: type: array description: Array of timeline IDs. maxItems: 100 items: $ref: '#/components/schemas/timeline_id' responses: '200': description: Request was successful. content: application/json: schema: type: object properties: success: $ref: '#/components/schemas/success' response: type: array description: >- Endpoint-specific response payload, or an error message when `success` is false. items: type: object properties: timeline_id: $ref: '#/components/schemas/timeline_id' created_at: $ref: '#/components/schemas/created_at' strategy_id: $ref: '#/components/schemas/strategy_id' name: type: string description: Display name. user_id: $ref: '#/components/schemas/user_id' likes: type: string description: Like count. liked: type: boolean description: Whether the authenticated user liked the event. type: type: string description: Type or category for this object. data: type: object description: Timeline event-specific payload. properties: history_id: type: string description: Trade history identifier. action: type: string description: Order or signal action. price: type: string description: Price or execution price, depending on context. amount: type: string description: Amount. fee_total: type: string description: Total fee for a trade event. total: type: string description: >- Total value; for positions/orders this is strategy-normalized unless documented otherwise. new_holdings: type: string description: Holdings after the trade event. strategy_value: type: string description: >- Normalized strategy value. Convert before displaying user-facing USD values. stock_id: $ref: '#/components/schemas/stock_id' figi_composite: type: - string - 'null' description: Composite FIGI identifier when available. symbol: type: string description: Ticker or asset symbol. name: type: string description: Display name. sector: type: string description: Sector or asset category. security: type: string enum: - cryptocurrency - stock description: Security type, such as stock or cryptocurrency. exchange: type: string description: Exchange code. stock: type: string description: Stock symbol as stored by AlphaInsider. peg: type: string description: Peg or quote currency. provider: type: string enum: - coinbase - binance - massive - alphainsider description: External provider or data provider. slippage: type: string description: Slippage value or configured slippage fraction. fee: type: string description: Fee value. links: type: object description: External research and market-data links. stock_status: type: string enum: - active - deleted description: Current stock status. examples: '200': value: success: true response: - timeline_id: '1312821' created_at: '2024-10-04T12:32:12.975Z' strategy_id: idminF5SDHUyiPCDMkYOm name: Ethereum = Moon user_id: crypto_user likes: '0' liked: false type: trade data: history_id: TYx0M5NquN1nap_h1g93S action: buy price: '2395.421280000000000' amount: '0.001043657756935' fee_total: '0.000000000000000' total: '2.500000000000000' new_holdings: '0.005722668735953' strategy_value: '11.184990058888979' stock_id: v3lhjrwEhNuAOxPT29oxO figi_composite: null symbol: ETH-USD name: Ethereum sector: Cryptocurrencies security: cryptocurrency exchange: COINBASE stock: ETH-USD peg: USD provider: coinbase slippage: '0.000000000000000' fee: '0.002500000000000' links: trading_view: >- https://www.tradingview.com/symbols/ETHUSD/?exchange=COINBASE yahoo_finance: https://finance.yahoo.com/quote/ETH-USD coin_marketcap: https://coinmarketcap.com/currencies/ethereum/ google_finance: https://www.google.com/finance/quote/ETH-USD stock_status: active - timeline_id: '1293758' created_at: '2024-08-08T13:21:41.413Z' strategy_id: idminF5SDHUyiPCDMkYOm name: Ethereum = Moon user_id: crypto_user likes: '0' liked: false type: post data: post_id: fHa1j_eSiI9IITrxKjJv8 description: >- I may have missed the timing for when to get into Ethereum but I have strong conviction that we will be seeing new all-time highs by end of this year or the next. Ethereum just hit the 200 weekly moving average and this usually means a bottom for the asset. url: https://www.tradingview.com/x/vtnvSnWk/ content: site: www.tradingview.com type: summary image: >- https://alphainsider-images.s3.us-east-2.amazonaws.com/1X99HjM6MNfEnK8KM69Fy title: BITFINEX:ETHUSD Chart Image by CryptoHitchhiker description: '' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' components: parameters: optional_api_token: in: header name: Authorization description: User API token. schema: type: string format: JWT schemas: timeline_id: type: string description: Timeline event identifier. success: type: boolean description: True when the request succeeded. created_at: type: string format: date-time description: Creation timestamp. strategy_id: type: string description: AlphaInsider strategy identifier. user_id: type: string description: AlphaInsider user identifier. stock_id: type: string description: AlphaInsider stock identifier, or `SYMBOL:EXCHANGE` in requests. responses: '400': description: Request failed. content: application/json: schema: type: object properties: success: type: boolean description: False when the request failed. response: type: string description: Error message. examples: '400': value: success: false response: Request failed. '401': description: Authentication failed. content: application/json: schema: type: object properties: success: type: boolean description: False when the request failed. response: type: string description: Error message. examples: '401': value: success: false response: Authentication failed. ````