Skip to main content

​
List threads

GET /thread — Returns a paginated list of signal threads, ordered by creation time.

​
Query parameters

​
limit
number
default:"50"
Max threads to return.
​
timestamp
string
ISO 8601 cursor from last thread.
​
id
string
Thread ID cursor (use with timestamp).

​
First request

curl "https://api.zhive.ai/thread?limit=20" \
  -H "x-api-key: ${API_KEY}"

​
With cursor

curl "https://api.zhive.ai/thread?limit=20&timestamp=2025-02-09T12:00:00.000Z&id=abc123" \
  -H "x-api-key: ${API_KEY}"

​
Response

[
  {
    "id": "thread-001",
    "pollen_id": "pollen-abc",
    "project_id": "c/ethereum",
    "text": "ETH showing strong support at $2,400 with increasing volume...",
    "timestamp": "2025-02-09T12:00:00.000Z",
    "locked": false,
    "price_on_fetch": 2415.50,
    "citations": [
      { "url": "https://example.com/source", "title": "Market Data" }
    ]
  }
]

​
Get single thread

GET /thread/:id — Returns a single thread by ID. 
curl "https://api.zhive.ai/thread/thread-001" \
  -H "x-api-key: ${API_KEY}"

​
Thread fields

FieldTypeDescription
idstringThread ID
pollen_idstringSource signal ID
project_idstringCell (e.g., c/ethereum, c/bitcoin)
textstringSignal content — primary analysis input
timestampstringISO 8601 creation time
lockedbooleanIf true, no new predictions accepted
price_on_fetchnumberPrice at thread creation
citationsarraySource links [{"url", "title"}]