Analytics V2 - Linq Alpha API Docs

curl --request POST \
  --url https://api.linqalpha.com/v2/analytics/sse \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "query": "What are the latest insights on AAPL performance?",
  "search_types": {
    "external": [
      {
        "type": "transcript"
      },
      {
        "type": "filing"
      }
    ]
  }
}
'

{
  "event_name": "conversation",
  "data": {
    "conversation_id": "7622b901-93ee-44bb-afb3-d60df76e31bf",
    "message": "Successfully created a conversation."
  }
}

Analytics V2

Agentic analytics with structured source selection, hard/soft filters, and identity fields.

search_types: Choose sources — rms (internal docs), external (transcripts, filings), structured
filters.rms.hard_filters / soft_filters: Hard = exclude non-matching (AND between fields, OR within arrays). Soft = boost relevance only.
organization_id and user_id: Optional (required only for platform API keys)

Event Flow

conversation            ← conversation_id
message                 ← echo of user query
status: start           ← stream begins
+-- AGENTIC LOOP (repeats) ---------+
|  tool_use_block (x1-3)            |
|  tool_result_block (x1-3)         |
|  keepalive (~15s)                 |
|  think (xN)                       |
+------------------------------------+
answer                  ← full answer with [1][2] citations
status: finish          ← stream ends

Retrieving References

After the stream finishes, use conversation_id to get citation sources:

GET /v2/analytics/conversations/{conversation_id}/references

Returns normalized references with enriched metadata. See Analytics V2 References for details.

POST

analytics

sse

curl --request POST \
  --url https://api.linqalpha.com/v2/analytics/sse \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "query": "What are the latest insights on AAPL performance?",
  "search_types": {
    "external": [
      {
        "type": "transcript"
      },
      {
        "type": "filing"
      }
    ]
  }
}
'

{
  "event_name": "conversation",
  "data": {
    "conversation_id": "7622b901-93ee-44bb-afb3-d60df76e31bf",
    "message": "Successfully created a conversation."
  }
}

Authorizations

X-API-KEY

string

header

required

Body

application/json

query

string

required

The analytics query to process.

Example:

"What are the latest insights on AAPL earnings?"

organization_id

string<uuid>

Organization ID

user_id

string<uuid>

User ID

user_email

string<email>

User email

user_name

string

User name

conversation_id

string | null

Existing conversation ID for multi-turn continuation. Omit or null for new conversation.

search_types

object

Structured source selection. Controls which document sources to query. Omitting a category means don't search it.

Show child attributes

filters

object

Metadata filters. Hard filters exclude non-matching documents (AND between fields, OR within arrays). Soft filters boost relevance without excluding.

Show child attributes

Response

SSE stream of analytics events. Each event is sent as data: {json}\n\n. Events follow the sequence: conversation → message → status:start → [agentic loop] → answer → status:finish. status:keep_alive and keepalive events are sent periodically during long tool execution gaps.

Conversation event

event_name

enum<string>

required

Available options:

conversation

data

object

required

Event-specific data payload

Show child attributes

Delete Conversation Feedback Analytics V2 References

⌘I

Documentation Index

Authorizations

Body

Response