Your intelligence, in your own tools.

GET/feed

Every key event across your markets between two dates: the same items your Paldo Key Events tab shows, in one list, newest event first. Each item has a kind: "company" is a story about a company from your intelligence feeds, "topic" is a research finding on a topic you track, and "deal" is an M&A deal card. A story that belongs to several of your markets is one item listing all of them in markets. date_range is when the events took place, and sources lists the linked pages behind the item.

Company stories carry company and topic: null. Topic cards carry the tracked topic's name in topic and company: null. A deal card looks like a company story when a company from your market is in the deal; otherwise it carries topic: "M&A radar". A feed is published about daily and covers the week before it, so the same company story recurs across overlapping feeds; those copies are folded into one item that keeps the newest telling. first_seen and last_seen say when Paldo found the item: the first and last feed in your window that carried a company story, the research runs that found a topic card, or when a deal card was created.

curl -H "Authorization: Bearer pk_live_your_key_here" \
     "https://www.paldoapp.com/api/public/v1/feed?since=2026-10-01&until=2026-10-14"

{
  "bundle": "Your Company",
  "since": "2026-10-01T00:00:00.000Z",
  "until": "2026-10-14T23:59:59.999Z",
  "stories": [
    {
      "kind": "topic",
      "title": "EU agrees battery passport rules for industrial batteries",
      "company": null,
      "topic": "EU battery regulation",
      "markets": [{ "id": "…", "name": "Nordic Industrials" }],
      "summary": "…",
      "detailed_summary": null,
      "event_type": "Market Signal",
      "sentiment": "neutral",
      "importance_score": 8,
      "strategic_signals": [],
      "key_insights": [],
      "date_range": { "start": "2026-10-10", "end": "2026-10-11" },
      "sources": [{ "url": "https://…", "title": "…", "date": "2026-10-11" }],
      "first_seen": "2026-10-12T…",
      "last_seen": "2026-10-13T…"
    },
    {
      "kind": "company",
      "title": "Competitor X: expands into Sweden",
      "company": "Competitor X",
      "topic": null,
      "markets": [{ "id": "…", "name": "Nordic Industrials" }],
      "summary": "…",
      "detailed_summary": "…",
      "event_type": "expansion",
      "sentiment": "neutral",
      "importance_score": 8,
      "strategic_signals": ["…"],
      "key_insights": ["…"],
      "date_range": { "start": "2026-10-06T…", "end": "2026-10-08T…" },
      "sources": [{ "url": "https://…", "title": "…", "date": "2026-10-07T…" }],
      "first_seen": "2026-10-09T…",
      "last_seen": "2026-10-14T…"
    }
  ],
  "total": 142,
  "next_offset": 100
}

GET/predictions

The predictions your Paldo Predictions tab shows: a concrete call about your market with a deadline, the chance of each outcome now, why it matters to you, and the research behind it. Each prediction is researched again as news comes in; you always get its latest research. Newest first. Predictions dismissed in the app are excluded.

status is pending (written, not yet researched: chances is null and evidence is empty), tracking (researched, open) or resolved (settled: resolved is {"outcome": "yes", "at": "…"}). chances maps each option to its probability now, 0 to 1. deadline is a date (YYYY-MM-DD), and language is the language the card is written in (for example "Norwegian"; null means English).

brief is the latest research written up, one text per section: bottom_line, where_it_stands, wider (the wider context), against (why it could still go the other way), settles (what would settle it) and watch (what to look for next). Sources are linked inline as Markdown [words](https://…); paragraphs are split by a blank line. evidence lists the developments the research found, each with the option it favours, its strength (1 to 5) and every source that reports it. wider_context has the same shape: what is happening around the prediction beyond the organisations it names. A source from Paldo's own signals has url: null.

curl -H "Authorization: Bearer pk_live_your_key_here" \
     "https://www.paldoapp.com/api/public/v1/predictions?status=tracking"

{
  "bundle": "Your Company",
  "predictions": [
    {
      "id": "…",
      "market": { "id": "…", "name": "Nordic Industrials" },
      "prediction": "Competitor X opens a production site in Sweden by 30 June 2027",
      "options": ["yes", "no"],
      "status": "tracking",
      "chances": { "yes": 0.62, "no": 0.38 },
      "deadline": "2027-06-30",
      "resolved": null,
      "language": "English",
      "why_it_matters": "…",
      "brief": {
        "bottom_line": "…",
        "where_it_stands": "…",
        "wider": "…",
        "against": "…",
        "settles": "…",
        "watch": "…"
      },
      "evidence": [
        {
          "text": "…",
          "favours": "yes",
          "strength": 4,
          "date": "2026-10-09",
          "sources": [{ "url": "https://…", "title": "…", "date": "2026-10-09" }]
        }
      ],
      "wider_context": [],
      "last_researched": "2026-10-16T…",
      "first_authored": "2026-10-02T…",
      "last_updated": "2026-10-16T…"
    }
  ],
  "next_offset": null
}

GET/patterns

Forward-looking pattern cards across your markets (served at /predictions until October 2026, same fields): what we expect to happen, the reasoning, the evidence, and the tripwires that would confirm it. Dismissed and archived cards are excluded. Note: window is only set when the underlying material contains a real, documented deadline (a tender close, a permit expiry, a stated date); we never invent dates. For all other cards, lead_time_horizon carries the honest, fuzzier timing. Each card carries a scope: "company" cards are about one named company, while "market" cards are market-wide calls (regulation, structural shifts, cross-company patterns) and carry company: null by design.

curl -H "Authorization: Bearer pk_live_your_key_here" \
     "https://www.paldoapp.com/api/public/v1/patterns?since=2026-09-01"

{
  "bundle": "Your Company",
  "patterns": [
    {
      "id": "…",
      "market": { "id": "…", "name": "Nordic Industrials" },
      "scope": "company",
      "company": "Competitor X",
      "title": "…",
      "description": "…",
      "kind": "…",
      "state": "…",
      "endorsed": false,
      "lead_time_horizon": "…",
      "window": { "text": "Q4 2026", "date": "2026-11-01" },
      "evidence": [],
      "tripwires": [],
      "first_observed": "2026-08-01T…",
      "last_updated_at": "2026-08-15T…"
    }
  ],
  "next_offset": null
}

GET/opportunities

Deal opportunities surfaced across your markets: tenders, buying signals and early-stage openings, with deadlines, buyers, rivals and suggested actions.

{
  "bundle": "Your Company",
  "opportunities": [
    {
      "id": "…",
      "market": { "id": "…", "name": "Nordic Industrials" },
      "title": "Oslo kommune: framework tender for …",
      "description": "…",
      "buyer": "Oslo kommune",
      "deadline": "2026-09-12",
      "estimated_value": "…",
      "state": "active",
      "endorsed": true,
      "dismissed": false,
      "suggested_action": "…",
      "why_us": "…",
      "rivals": [],
      "evidence": [],
      "first_observed": "2026-08-10T…",
      "last_updated_at": "2026-08-16T…"
    }
  ],
  "next_offset": null
}