Skip to main content
GET
/
v1
/
signals
/
{signal_id}
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals/0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7?include=evidence&verification_detail=full"

{
  "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",
  "tags": {
    "value_chain": ["Infrastructure"],
    "market_force": ["Competitive Dynamics"]
  },
  "entities": [
    {"entity_id": "gld:/a1b2c3d4e5f6", "name": "NVIDIA", "type": "organization"}
  ],
  "decomposition": {
    "thesis": {
      "thesis_id": "0002a4b8c0d1e3f5a7b9c8d0e2f4a6b8c0d1e3f5",
      "text": "NVIDIA's H200 shipments increased significantly in Q4 as supply chain constraints eased across the semiconductor industry.",
      "sentences": [
        {
          "unit": {
            "unit_id": "0005a1b2c3d4e5f60718293a4b5c6d7e8f9a0b1c",
            "unit_type": "thesis_sentence",
            "text": "NVIDIA's H200 shipments increased significantly in Q4.",
            "position_in_source": 1,
            "parent_id": "0002a4b8c0d1e3f5a7b9c8d0e2f4a6b8c0d1e3f5"
          },
          "verification": {
            "final_verdict": "pass",
            "verification_path": "auto_pass",
            "was_human_reviewed": false,
            "scoring_mode": "regression",
            "primary_score": 0.8912
          }
        }
      ]
    },
    "arguments": [
      {
        "argument_id": "00035c9d1e0f2a4b6c8d0e2f4a6b8c0d1e3f5a7b",
        "sentences": [
          {
            "unit": {
              "unit_id": "0005d4e5f607182939a4b5c6d7e8f9a0b1c2d3e4",
              "unit_type": "argument_sentence",
              "text": "Supply chain bottlenecks eased following TSMC capacity expansion.",
              "position_in_source": 1,
              "parent_id": "00035c9d1e0f2a4b6c8d0e2f4a6b8c0d1e3f5a7b"
            },
            "verification": {
              "final_verdict": "pass",
              "verification_path": "auto_pass",
              "was_human_reviewed": false,
              "scoring_mode": "regression",
              "primary_score": 0.8234
            }
          }
        ]
      }
    ],
    "claims": [
      {
        "unit": {
          "unit_id": "0004c6d0e2f1a3b5c7d9e1f3a5b7c9d1e3f5a7b9",
          "unit_type": "analysis_claim",
          "text": "NVIDIA increased H200 shipments by 40% quarter-over-quarter.",
          "position_in_source": 1,
          "parent_id": "0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7"
        },
        "verification": {
          "final_verdict": "pass",
          "verification_path": "auto_pass",
          "was_human_reviewed": false,
          "scoring_mode": "nli",
          "primary_score": 0.7421
        }
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gildea.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
signal_id
string
required
Unique signal identifier (e.g., 0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7).
​
include
string
Comma-separated list of optional fields to include. Values:
  • evidence — include full evidence snippets per text unit (100-char preview + verification metadata)
  • embeddings — include 1024-dim Cohere embed-english-v3.0 embedding vectors per text unit, in the same space as POST /v1/embed output
Combine with a comma: include=evidence,embeddings.
​
verification_detail
string
Set to full for complete verification metadata (scores, thresholds, method).
title, url, and published_at always describe the full source. The decomposition 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 article title. Describes the full source, not necessarily the extracted segment.
​
url
string
Source article URL. Links to the full source.
​
published_at
string
ISO 8601 publication date of the full source.
​
content_type
string
analysis or factual_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.
Each unit object inside the decomposition includes a position_in_source field — its 1-indexed position within the parent in the source article. Gaps in the sequence (e.g. 1, 3, 5) are intentional: missing positions correspond to sibling units that failed verification and were pruned. See Verification for the trust contract.
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals/0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7?include=evidence&verification_detail=full"

{
  "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",
  "tags": {
    "value_chain": ["Infrastructure"],
    "market_force": ["Competitive Dynamics"]
  },
  "entities": [
    {"entity_id": "gld:/a1b2c3d4e5f6", "name": "NVIDIA", "type": "organization"}
  ],
  "decomposition": {
    "thesis": {
      "thesis_id": "0002a4b8c0d1e3f5a7b9c8d0e2f4a6b8c0d1e3f5",
      "text": "NVIDIA's H200 shipments increased significantly in Q4 as supply chain constraints eased across the semiconductor industry.",
      "sentences": [
        {
          "unit": {
            "unit_id": "0005a1b2c3d4e5f60718293a4b5c6d7e8f9a0b1c",
            "unit_type": "thesis_sentence",
            "text": "NVIDIA's H200 shipments increased significantly in Q4.",
            "position_in_source": 1,
            "parent_id": "0002a4b8c0d1e3f5a7b9c8d0e2f4a6b8c0d1e3f5"
          },
          "verification": {
            "final_verdict": "pass",
            "verification_path": "auto_pass",
            "was_human_reviewed": false,
            "scoring_mode": "regression",
            "primary_score": 0.8912
          }
        }
      ]
    },
    "arguments": [
      {
        "argument_id": "00035c9d1e0f2a4b6c8d0e2f4a6b8c0d1e3f5a7b",
        "sentences": [
          {
            "unit": {
              "unit_id": "0005d4e5f607182939a4b5c6d7e8f9a0b1c2d3e4",
              "unit_type": "argument_sentence",
              "text": "Supply chain bottlenecks eased following TSMC capacity expansion.",
              "position_in_source": 1,
              "parent_id": "00035c9d1e0f2a4b6c8d0e2f4a6b8c0d1e3f5a7b"
            },
            "verification": {
              "final_verdict": "pass",
              "verification_path": "auto_pass",
              "was_human_reviewed": false,
              "scoring_mode": "regression",
              "primary_score": 0.8234
            }
          }
        ]
      }
    ],
    "claims": [
      {
        "unit": {
          "unit_id": "0004c6d0e2f1a3b5c7d9e1f3a5b7c9d1e3f5a7b9",
          "unit_type": "analysis_claim",
          "text": "NVIDIA increased H200 shipments by 40% quarter-over-quarter.",
          "position_in_source": 1,
          "parent_id": "0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7"
        },
        "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

Comma-separated list of optional fields to include. Values: 'evidence' (full evidence snippets), 'embeddings' (1024-dim Cohere embed-english-v3.0 vectors per 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:

"0001f3a7b9c8d4e5f6a7b8c9d0e1f2a3b4c5d6e7"

​
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 'factual_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.