List Signals - Gildea API

curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals?entity=NVIDIA&limit=5"

{
  "data": [
    {
      "signal_id": "0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
      "title": "NVIDIA H200 Shipments Surge as Supply Eases",
      "url": "https://example.com/article",
      "published_at": "2026-01-15T10:00:00Z",
      "registrable_domain": "example.com",
      "content_type": "analysis",
      "author": "John Smith",
      "decomposition_text": "NVIDIA's H200 shipments increased significantly in Q4 as supply chain constraints eased.",
      "tags": {
        "value_chain": ["Infrastructure"],
        "market_force": ["Competitive Dynamics"]
      },
      "entities": [
        {"entity_id": "gld:/a1b2c3d4e5f6", "name": "NVIDIA", "type": "organization"}
      ],
      "verified_text_unit_count": 12
    }
  ],
  "has_more": true,
  "next_cursor": "eyJwdWJsaXNoZWRfYXQiOiIyMDI2LTAxLTE1VDEwOjAwOjAwWiJ9"
}

GET

signals

curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals?entity=NVIDIA&limit=5"

{
  "data": [
    {
      "signal_id": "0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
      "title": "NVIDIA H200 Shipments Surge as Supply Eases",
      "url": "https://example.com/article",
      "published_at": "2026-01-15T10:00:00Z",
      "registrable_domain": "example.com",
      "content_type": "analysis",
      "author": "John Smith",
      "decomposition_text": "NVIDIA's H200 shipments increased significantly in Q4 as supply chain constraints eased.",
      "tags": {
        "value_chain": ["Infrastructure"],
        "market_force": ["Competitive Dynamics"]
      },
      "entities": [
        {"entity_id": "gld:/a1b2c3d4e5f6", "name": "NVIDIA", "type": "organization"}
      ],
      "verified_text_unit_count": 12
    }
  ],
  "has_more": true,
  "next_cursor": "eyJwdWJsaXNoZWRfYXQiOiIyMDI2LTAxLTE1VDEwOjAwOjAwWiJ9"
}

entity

string

Filter by entity public ID (gld:/…) or exact entity name (case-insensitive).

theme

string

Filter by theme label (e.g., “Infrastructure”).

string

Keyword filter on signal title and decomposition text. Matches signals whose text contains the query terms — this is a list filter, not a relevance-ranked search. For relevance-ranked retrieval across verified text units, use GET /v1/search instead.

content_type

string

Filter by content type: analysis or factual_event.

published_after

string

ISO 8601 date — only signals published after this date.

published_before

string

ISO 8601 date — only signals published before this date.

limit

integer

default:"25"

Results per page (1–50).

cursor

string

Opaque pagination cursor from a previous response.

All filters are optional. Without filters, returns the most recent signals sorted by date.

data

array

List of signal objects.

Show Signal object

signal_id

string

Unique signal identifier.

title

string

Source article title. Describes the full source, not necessarily the extracted segment — see Signal scope.

url

string

Source article URL. Links to the full source.

published_at

string

ISO 8601 publication date of the full source.

registrable_domain

string

Source domain (e.g., example.com).

content_type

string

analysis or factual_event.

author

string

Article author, if available.

decomposition_text

string

Thesis text (analysis) or summary text (event). Reflects the extracted signal, which may be narrower than the full source.

tags

object

Theme tags with value_chain and market_force arrays.

entities

array

Entities mentioned in this signal.

verified_text_unit_count

integer

Count of verified text units in decomposition.

has_more

boolean

Whether more results exist.

next_cursor

string

Cursor for the next page. Pass as cursor parameter.

curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals?entity=NVIDIA&limit=5"

{
  "data": [
    {
      "signal_id": "0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
      "title": "NVIDIA H200 Shipments Surge as Supply Eases",
      "url": "https://example.com/article",
      "published_at": "2026-01-15T10:00:00Z",
      "registrable_domain": "example.com",
      "content_type": "analysis",
      "author": "John Smith",
      "decomposition_text": "NVIDIA's H200 shipments increased significantly in Q4 as supply chain constraints eased.",
      "tags": {
        "value_chain": ["Infrastructure"],
        "market_force": ["Competitive Dynamics"]
      },
      "entities": [
        {"entity_id": "gld:/a1b2c3d4e5f6", "name": "NVIDIA", "type": "organization"}
      ],
      "verified_text_unit_count": 12
    }
  ],
  "has_more": true,
  "next_cursor": "eyJwdWJsaXNoZWRfYXQiOiIyMDI2LTAxLTE1VDEwOjAwOjAwWiJ9"
}

Authorizations

X-API-Key

string

header

required

API key for authentication. Include in every request as X-API-Key: gld_your_key_here.

Query Parameters

entity

string | null

Filter by entity public ID (gld:/…) or exact entity name (case-insensitive). Get public IDs from any entity_id field via GET /v1/entities.

theme

string | null

Filter by theme label.

string | null

Keyword filter on signal title and decomposition text (list filter, not relevance-ranked). For relevance-ranked retrieval use GET /v1/search.

content_type

string | null

Filter by content type: 'analysis' or 'factual_event'.

published_after

string | null

ISO 8601 date — only signals published after this date.

published_before

string | null

ISO 8601 date — only signals published before this date.

cursor

string | null

limit

integer

default:25

Required range: 1 <= x <= 50

Response

Successful Response

has_more

boolean

required

Whether more results are available beyond this page.

data

SignalCard · object[]

required

List of signal cards matching the query.

Show child attributes

next_cursor

string | null

Opaque cursor to pass as cursor query param for the next page. Null when has_more is false.

API Reference Overview

Get Signal

Documentation Index

Authorizations

Query Parameters

Response