Skip to main content
GET
/
v1
/
signals
/
{signal_id}
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals/sig_01JABCDEF123456789?include=evidence&verification_detail=full"
{
  "signal_id": "sig_01JABCDEF123456789",
  "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",
  "tags": {
    "value_chain": ["Infrastructure"],
    "market_force": ["Competitive Dynamics"]
  },
  "entities": [
    {"entity_id": "org:/nvidia", "name": "NVIDIA", "type": "Organization"}
  ],
  "decomposition": {
    "thesis": {
      "thesis_id": "thes_01J...",
      "text": "NVIDIA's H200 shipments increased significantly in Q4 as supply chain constraints eased across the semiconductor industry.",
      "sentences": [
        {
          "unit": {
            "unit_id": "ts_01J...",
            "unit_type": "thesis_sentence",
            "text": "NVIDIA's H200 shipments increased significantly in Q4.",
            "display_order": 1,
            "parent_id": "thes_01J..."
          },
          "verification": {
            "final_verdict": "pass",
            "verification_path": "auto_pass",
            "was_human_reviewed": false,
            "scoring_mode": "regression",
            "primary_score": 0.8912
          }
        }
      ]
    },
    "arguments": [
      {
        "argument_id": "arg_01J...",
        "sentences": [
          {
            "unit": {
              "unit_id": "as_01J...",
              "unit_type": "argument_sentence",
              "text": "Supply chain bottlenecks eased following TSMC capacity expansion.",
              "display_order": 1,
              "parent_id": "arg_01J..."
            },
            "verification": {
              "final_verdict": "pass",
              "verification_path": "auto_pass",
              "was_human_reviewed": false,
              "scoring_mode": "regression",
              "primary_score": 0.8234
            }
          }
        ],
        "claims": [
          {
            "unit": {
              "unit_id": "clm_01J...",
              "unit_type": "analysis_claim",
              "text": "NVIDIA increased H200 shipments by 40% quarter-over-quarter.",
              "display_order": 1,
              "parent_id": "arg_01J..."
            },
            "verification": {
              "final_verdict": "pass",
              "verification_path": "auto_pass",
              "was_human_reviewed": false,
              "scoring_mode": "nli",
              "primary_score": 0.7421
            }
          }
        ]
      }
    ]
  }
}
signal_id
string
required
Unique signal identifier (e.g., sig_01JABCDEF123456789).
include
string
Set to evidence to include evidence snippets per text unit. Each snippet shows a 100-character preview prefix.
verification_detail
string
Set to full for complete verification metadata (scores, thresholds, method).
signal_id
string
Unique signal identifier.
title
string
Source article title.
url
string
Source article URL.
published_at
string
ISO 8601 publication date.
content_type
string
analysis or event.
tags
object
Theme tags with value_chain and market_force arrays.
entities
array
Entities mentioned in this signal.
decomposition
object
Full verified decomposition tree. Structure depends on content_type.
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals/sig_01JABCDEF123456789?include=evidence&verification_detail=full"
{
  "signal_id": "sig_01JABCDEF123456789",
  "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",
  "tags": {
    "value_chain": ["Infrastructure"],
    "market_force": ["Competitive Dynamics"]
  },
  "entities": [
    {"entity_id": "org:/nvidia", "name": "NVIDIA", "type": "Organization"}
  ],
  "decomposition": {
    "thesis": {
      "thesis_id": "thes_01J...",
      "text": "NVIDIA's H200 shipments increased significantly in Q4 as supply chain constraints eased across the semiconductor industry.",
      "sentences": [
        {
          "unit": {
            "unit_id": "ts_01J...",
            "unit_type": "thesis_sentence",
            "text": "NVIDIA's H200 shipments increased significantly in Q4.",
            "display_order": 1,
            "parent_id": "thes_01J..."
          },
          "verification": {
            "final_verdict": "pass",
            "verification_path": "auto_pass",
            "was_human_reviewed": false,
            "scoring_mode": "regression",
            "primary_score": 0.8912
          }
        }
      ]
    },
    "arguments": [
      {
        "argument_id": "arg_01J...",
        "sentences": [
          {
            "unit": {
              "unit_id": "as_01J...",
              "unit_type": "argument_sentence",
              "text": "Supply chain bottlenecks eased following TSMC capacity expansion.",
              "display_order": 1,
              "parent_id": "arg_01J..."
            },
            "verification": {
              "final_verdict": "pass",
              "verification_path": "auto_pass",
              "was_human_reviewed": false,
              "scoring_mode": "regression",
              "primary_score": 0.8234
            }
          }
        ],
        "claims": [
          {
            "unit": {
              "unit_id": "clm_01J...",
              "unit_type": "analysis_claim",
              "text": "NVIDIA increased H200 shipments by 40% quarter-over-quarter.",
              "display_order": 1,
              "parent_id": "arg_01J..."
            },
            "verification": {
              "final_verdict": "pass",
              "verification_path": "auto_pass",
              "was_human_reviewed": false,
              "scoring_mode": "nli",
              "primary_score": 0.7421
            }
          }
        ]
      }
    ]
  }
}

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

Query Parameters

include
string | null

Set to 'evidence' to include full evidence snippets per text unit.

verification_detail
string | null

Set to 'full' for complete verification metadata (scores, thresholds, method).

Response

Successful Response

signal_id
string
required

Unique signal identifier.

Example:

"sig_01JABCDEF123456789"

url
string
required

Original source URL.

decomposition
Decomposition · object
required

Full verified decomposition tree. Shape varies by content_type (analysis → thesis + arguments, event → summary + claims).

title
string | null

Signal headline.

published_at
string<date-time> | null

Publication timestamp (ISO 8601).

registrable_domain
string | null

Source domain.

Example:

"reuters.com"

content_type
string | null

'analysis' or 'event'.

Example:

"analysis"

author
string | null

Author name if available.

tags
Tags · object

Taxonomy tags: value_chain and market_force arrays.

Example:
{
  "market_force": ["Competitive Dynamics"],
  "value_chain": ["AI Infrastructure"]
}
entities
Entities · object[]

Entities mentioned in this signal.