Skip to main content
GET
/
v1
/
signals
/
{signal_id}
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals/0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7"
import requests

signal = requests.get(
    "https://api.gildea.ai/v1/signals/0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
    headers={"X-API-Key": "gld_your_key"},
).json()
const resp = await fetch(
  "https://api.gildea.ai/v1/signals/0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
  { headers: { "X-API-Key": "gld_your_key" } }
);
const signal = await resp.json();
{
  "signal_id": "0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
  "title": "NVIDIA H200 Shipments Surge as Supply Eases",
  "url": "https://reuters.com/article",
  "published_at": "2026-01-15T10:00:00Z",
  "content_type": "analysis",
  "domain": "reuters.com",
  "verified_unit_count": 3,
  "themes": {
    "value_chain": ["Infrastructure"],
    "market_force": ["Competitive Dynamics"]
  },
  "entities": [
    { "entity_id": "gld:/a1b2c3d4e5f6", "name": "NVIDIA", "type": "organization" }
  ],
  "units": [
    {
      "id": "0005a1b2c3d4e5f60718293a4b5c6d7e8f9a0b1c",
      "role": "thesis",
      "text": "NVIDIA's H200 shipments increased significantly in Q4 as supply constraints eased.",
      "verification": { "human_reviewed": true },
      "evidence": {
        "snippets": [
          { "text": "NVIDIA shipped over 400,000 H200 units in Q4, a 40% increase from…", "truncated": true }
        ]
      }
    },
    {
      "id": "0005d4e5f607182939a4b5c6d7e8f9a0b1c2d3e4",
      "role": "argument",
      "text": "Supply chain bottlenecks eased following TSMC capacity expansion.",
      "argument_id": "a1",
      "evidence": {
        "snippets": [{ "text": "TSMC brought new CoWoS capacity online in late Q3…", "truncated": true }]
      }
    },
    {
      "id": "0004c6d0e2f1a3b5c7d9e1f3a5b7c9d1e3f5a7b9",
      "role": "claim",
      "text": "NVIDIA increased H200 shipments by 40% quarter-over-quarter.",
      "evidence": {
        "snippets": [{ "text": "…a 40% increase from the prior quarter.", "truncated": false }]
      }
    }
  ]
}
{
  "signal_id": "0001ace1234567890abcdef0123456789abcdef0",
  "title": "EU Reaches Political Agreement on AI Act Implementation",
  "url": "https://reuters.com/eu-ai-act",
  "published_at": "2026-01-20T14:00:00Z",
  "content_type": "event",
  "domain": "reuters.com",
  "verified_unit_count": 2,
  "themes": {
    "value_chain": ["Applications"],
    "market_force": ["Regulatory & Legal"]
  },
  "entities": [
    { "entity_id": "gld:/7c4e1a90b2d3", "name": "EU AI Act", "type": "regulation_policy" }
  ],
  "units": [
    {
      "id": "00057a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f",
      "role": "synopsis",
      "text": "The European Union reached a political agreement on implementing the AI Act.",
      "evidence": {
        "snippets": [{ "text": "EU member states reached agreement on the AI Act's implementation timeline…", "truncated": true }]
      }
    },
    {
      "id": "0004fed987654321ba9876543210fedcba987654",
      "role": "claim",
      "text": "General-purpose AI models must meet transparency requirements by August 2026.",
      "evidence": {
        "snippets": [{ "text": "…transparency obligations take effect in August 2026.", "truncated": false }]
      }
    }
  ]
}
{
  "error": {
    "code": "not_found",
    "message": "Signal 'sig_nonexistent' not found",
    "status": 404
  }
}
signal_id
string
required
Unique signal identifier (e.g., 0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7).
title, url, and published_at always describe the full source. The units below may reflect only a segment of that source (e.g., a five-minute exchange in a two-hour podcast). See Signal scope vs. source scope.
signal_id
string
Unique signal identifier.
title
string
Source title. Describes the full source, not necessarily the extracted segment.
url
string
Source URL. Links to the full source.
published_at
string
ISO 8601 publication date of the full source.
content_type
string
analysis or event.
domain
string
Source registrable domain (e.g. reuters.com).
verified_unit_count
integer
Number of verified units; equals the length of units. The honest depth signal; use it, not statement length, to gauge analytical depth.
themes
object
Themes with value_chain and market_force arrays.
entities
array
Entities mentioned in this signal (entity_id, name, type).
units
array
Flat list of verified units, grouped by role (central statement → arguments → claims) in document order. List position is the order; there is no separate index field.
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals/0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7"
import requests

signal = requests.get(
    "https://api.gildea.ai/v1/signals/0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
    headers={"X-API-Key": "gld_your_key"},
).json()
const resp = await fetch(
  "https://api.gildea.ai/v1/signals/0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
  { headers: { "X-API-Key": "gld_your_key" } }
);
const signal = await resp.json();
{
  "signal_id": "0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
  "title": "NVIDIA H200 Shipments Surge as Supply Eases",
  "url": "https://reuters.com/article",
  "published_at": "2026-01-15T10:00:00Z",
  "content_type": "analysis",
  "domain": "reuters.com",
  "verified_unit_count": 3,
  "themes": {
    "value_chain": ["Infrastructure"],
    "market_force": ["Competitive Dynamics"]
  },
  "entities": [
    { "entity_id": "gld:/a1b2c3d4e5f6", "name": "NVIDIA", "type": "organization" }
  ],
  "units": [
    {
      "id": "0005a1b2c3d4e5f60718293a4b5c6d7e8f9a0b1c",
      "role": "thesis",
      "text": "NVIDIA's H200 shipments increased significantly in Q4 as supply constraints eased.",
      "verification": { "human_reviewed": true },
      "evidence": {
        "snippets": [
          { "text": "NVIDIA shipped over 400,000 H200 units in Q4, a 40% increase from…", "truncated": true }
        ]
      }
    },
    {
      "id": "0005d4e5f607182939a4b5c6d7e8f9a0b1c2d3e4",
      "role": "argument",
      "text": "Supply chain bottlenecks eased following TSMC capacity expansion.",
      "argument_id": "a1",
      "evidence": {
        "snippets": [{ "text": "TSMC brought new CoWoS capacity online in late Q3…", "truncated": true }]
      }
    },
    {
      "id": "0004c6d0e2f1a3b5c7d9e1f3a5b7c9d1e3f5a7b9",
      "role": "claim",
      "text": "NVIDIA increased H200 shipments by 40% quarter-over-quarter.",
      "evidence": {
        "snippets": [{ "text": "…a 40% increase from the prior quarter.", "truncated": false }]
      }
    }
  ]
}
{
  "signal_id": "0001ace1234567890abcdef0123456789abcdef0",
  "title": "EU Reaches Political Agreement on AI Act Implementation",
  "url": "https://reuters.com/eu-ai-act",
  "published_at": "2026-01-20T14:00:00Z",
  "content_type": "event",
  "domain": "reuters.com",
  "verified_unit_count": 2,
  "themes": {
    "value_chain": ["Applications"],
    "market_force": ["Regulatory & Legal"]
  },
  "entities": [
    { "entity_id": "gld:/7c4e1a90b2d3", "name": "EU AI Act", "type": "regulation_policy" }
  ],
  "units": [
    {
      "id": "00057a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f",
      "role": "synopsis",
      "text": "The European Union reached a political agreement on implementing the AI Act.",
      "evidence": {
        "snippets": [{ "text": "EU member states reached agreement on the AI Act's implementation timeline…", "truncated": true }]
      }
    },
    {
      "id": "0004fed987654321ba9876543210fedcba987654",
      "role": "claim",
      "text": "General-purpose AI models must meet transparency requirements by August 2026.",
      "evidence": {
        "snippets": [{ "text": "…transparency obligations take effect in August 2026.", "truncated": false }]
      }
    }
  ]
}
{
  "error": {
    "code": "not_found",
    "message": "Signal 'sig_nonexistent' not found",
    "status": 404
  }
}

Authorizations

X-API-Key
string
header
required

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

Path Parameters

signal_id
string
required

Response

Successful Response

Full signal as a flat list of verified units (grouped by role, in document order).

signal_id
string
required
Example:

"0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7"

url
string
required
title
string | null
published_at
string | null

Publication timestamp (ISO 8601).

content_type
enum<string> | null
Available options:
analysis,
event
Example:

"analysis"

domain
string | null

Source registrable domain.

Example:

"reuters.com"

verified_unit_count
integer
default:0

Number of verified units in the decomposition (equals len(units) in detail). The honest depth signal — use this, not statement length, to gauge analytical depth.

themes
Themes · object
entities
EntitySummary · object[]
units
Unit · object[]