Skip to content

Developer reference

Research data your agent can inspect.

Read versioned packs, inspect freshness and source context, compare versions and methodologies, explain positions, and export audit evidence. The v0.1 contract is frozen; REST and local MCP stdio are available now.

REST API

Available

Contract

v0.1 frozen

MCP transport

Local stdio

Quickstart

Get the curated filing view.

Set the base URL to this deployment or your local server, then request the manager-overlap view used by the live product experience.

Open live JSONView the pack
Shell
export SIGNALPACK_BASE_URL=http://localhost:3000

curl -s "$SIGNALPACK_BASE_URL/api/v1/packs/13f-copycat/latest?mode=overlap"

Available now

REST API

GET routes support ETags and explicit cache policy. Versioned responses use a stable data/meta or error/meta envelope; POST routes are no-store and include runnable examples.

System

2 endpoints
GET

Artifact release health

/api/v1/health
Open JSON

Check whether the current artifact set is consumable and inspect safe freshness/hash metadata.

Example

curl -s "$SIGNALPACK_BASE_URL/api/v1/health"

Response

  • — Returns the last atomically promoted immutable release. Internal releases remain degraded while fixture or scope warnings exist; a missing or integrity-invalid release returns a 503 error envelope.
  • — Refresh commands, snapshot locations, and local filesystem paths are never exposed.
GET

OpenAPI 3.1 contract

/api/v1/openapi.json
Open JSON

Machine-readable documentation for every versioned REST operation and its MCP mapping.

Example

curl -s "$SIGNALPACK_BASE_URL/api/v1/openapi.json"

Response

  • — Returns the raw OpenAPI document rather than the standard data/meta envelope.

Pack data

7 endpoints
GET

Pack catalog

/api/v1/packs
Open JSON

List available and planned packs with status, versioned links, and latest-version metadata.

Example

curl -s "$SIGNALPACK_BASE_URL/api/v1/packs"

Response

  • — Returns the standard data/meta envelope. Available packs include versioned latest and history links.
GETLaunch pack

Hedge Fund Filing Pack

/api/v1/packs/13f-copycat/latest
Open JSON

Give an agent clean multi-manager 13F changes, source records, ethos scores, and policy checks before it drafts any action.

ParameterDescription
managers

query · optional

Repeat the parameter or pass comma-separated manager IDs to filter the filing set.

mode

query · optional

One of any, overlap, exclusive, or disagreement. The API default is any.

Example

curl -s "$SIGNALPACK_BASE_URL/api/v1/packs/13f-copycat/latest?mode=overlap"

Response

  • — Returns the artifact, release manifest reference, available managers and view modes, selected view, and agent-ready payload.
  • — The endpoint defaults to the complete dataset. Add mode=overlap for the curated cross-manager view used by the website.
GETData preview

Pelosi Tracker

/api/v1/packs/pelosi-tracker/latest
Open JSON

Let an agent inspect estimated holdings, concentration, freshness, and official-filing caveats without scraping pages.

Example

curl -s "$SIGNALPACK_BASE_URL/api/v1/packs/pelosi-tracker/latest"

Response

  • — Returns the generated data-preview artifact and an agent-ready payload.
  • — Estimated holdings and official-filing reconciliation limits remain attached to the response.
GETData preview

House/Senate Clusters

/api/v1/packs/congress-trades/latest
Open JSON

Return a disciplined cluster pack that can say 'no signal, stay cash' instead of forcing trades.

Example

curl -s "$SIGNALPACK_BASE_URL/api/v1/packs/congress-trades/latest"

Response

  • — Returns the generated congressional-cluster preview and an agent-ready payload.
  • — Disclosure lag, relaxed demo thresholds, and strict-mode caveats remain attached to the response.
GETResearch preview

WallStreetBets Momentum

/api/v1/packs/wsb-social-momentum/latest
Open JSON

Expose social momentum as a small, clearly labeled research signal with volatility warnings and approval gates.

Example

curl -s "$SIGNALPACK_BASE_URL/api/v1/packs/wsb-social-momentum/latest"

Response

  • — Returns the generated social-momentum research preview and an agent-ready payload.
  • — This feed measures attention, not fundamental conviction; volatility and source caveats remain attached.
GET

Artifact version history

/api/v1/packs/{packId}/versions
Open JSON

List immutable artifact version references available for a pack.

ParameterDescription
packId

path · required

The SignalPack pack ID.

Example

curl -s "$SIGNALPACK_BASE_URL/api/v1/packs/13f-copycat/versions"

Response

  • — The 13F pack currently exposes eight common-quarter versions and identifies the current latest version.
GET13F history

Semantic version diff

/api/v1/packs/{packId}/versions/diff
Open JSON

Compare ticker, source, and policy changes between two canonical artifact versions.

ParameterDescription
packId

path · required

Currently version comparison is implemented for 13f-copycat.

from

query · required

The earlier artifact version.

to

query · required

The later artifact version.

managers

query · optional

Repeat the parameter or pass comma-separated manager IDs to filter the filing set.

mode

query · optional

One of any, overlap, exclusive, or disagreement. The API default is any.

Example

curl -s "$SIGNALPACK_BASE_URL/api/v1/packs/13f-copycat/versions/diff?from=multi-manager-2024-06-30-v0.6&to=multi-manager-2024-09-30-v0.6"

Response

  • — Diffs compare canonical PackArtifact fields; they do not infer why a manager or methodology changed.

Research

3 endpoints
GET13F only

Explain a position

/api/v1/packs/{packId}/positions/{ticker}/explanation
Open JSON

Trace a 13F result to manager moves, evidence quality, methodology scores, source records, and limitations.

ParameterDescription
packId

path · required

Currently structured explanations are implemented for 13f-copycat.

ticker

path · required

Ticker present in the selected view.

managers

query · optional

Repeat the parameter or pass comma-separated manager IDs to filter the filing set.

mode

query · optional

One of any, overlap, exclusive, or disagreement. The API default is any.

Example

curl -s "$SIGNALPACK_BASE_URL/api/v1/packs/13f-copycat/positions/GOOGL/explanation"

Response

  • — Returns the original structured change, evidence view model, ethos scores, overlap result, matching source records, and attached limitations.
GET13F scoring

Investing-methodology definitions

/api/v1/ethos
Open JSON

List the methodology definitions currently available to the 13F scoring surface.

Example

curl -s "$SIGNALPACK_BASE_URL/api/v1/ethos"

Response

  • — Returns methodology IDs, public names, principles, and scoring configuration.
POST13F only

Compare investing methodologies

/api/v1/ethos/compare

Recalculate supported methodology scores and agreement for a filtered 13F view.

ParameterDescription
packId

body · optional

Defaults to 13f-copycat; no other pack is supported yet.

managerIds

body · optional

Manager IDs to include in the filing view.

mode

body · optional

One of any, overlap, exclusive, or disagreement.

ethosIds

body · optional

Supported methodology IDs to compare.

tickers

body · optional

Tickers in the selected view to include.

Example

curl -s -X POST "$SIGNALPACK_BASE_URL/api/v1/ethos/compare"   -H "content-type: application/json"   -d '{"packId":"13f-copycat","mode":"any","tickers":["GOOGL"]}'

Response

  • — Returns the resolved view, selected methodology IDs, per-ticker scores, and cross-methodology overlap.

Guardrails

2 endpoints
POST13F only

Validate research policy

/api/v1/policy/validate

Recalculate the default policy checks for a filtered 13F research handoff.

ParameterDescription
packId

body · optional

Defaults to 13f-copycat; no other pack is supported yet.

managerIds

body · optional

Manager IDs to include in the filing view.

mode

body · optional

One of any, overlap, exclusive, or disagreement.

Example

curl -s -X POST "$SIGNALPACK_BASE_URL/api/v1/policy/validate"   -H "content-type: application/json"   -d '{"packId":"13f-copycat","mode":"overlap"}'

Response

  • — Returns policy checks, blocking reasons, and warnings. executionEnabled is always false.
GET

Export audit trail

/api/v1/packs/{packId}/audit
Open JSON

Export artifact identity, release reference, content hash, provenance, methodology, policy, and audit events.

ParameterDescription
packId

path · required

Any currently available pack.

managers

query · optional

Repeat the parameter or pass comma-separated manager IDs to filter the filing set.

mode

query · optional

One of any, overlap, exclusive, or disagreement. The API default is any.

Example

curl -s "$SIGNALPACK_BASE_URL/api/v1/packs/13f-copycat/audit?mode=overlap"

Response

  • — The export validates the PackArtifact schema before returning and includes a SHA-256 content digest.
Local stdio available

MCP tools

These names and semantics map one-to-one to the REST service contract through a local read-only stdio server. It has no brokerage, account, order, or execution access. Hosted transport and authentication remain separate future decisions.

get_health

Inspect artifact freshness and whether the current release is safe to consume.

list_packs

List available and planned SignalPack products.

get_latest_pack

Retrieve a current pack with source, freshness, limitation, and policy context.

list_pack_versions

List immutable versions currently available for a pack.

compare_versions

Return the canonical semantic diff between two artifact versions.

explain_position

Trace a position to manager behavior, scores, sources, quality checks, and caveats.

list_ethos

List the supported investing methodology definitions.

compare_ethos

Compare supported investing methodologies over a selected 13F view.

validate_policy

Recalculate research guardrails without granting execution authority.

export_audit_trail

Export version, provenance, methodology, policy, and event evidence for a pack.

Research only. Execution stays outside SignalPack.

The API returns evidence, methodology output, limitations, and policy checks. It does not hold credentials, connect to brokerages, route orders, or authorize autonomous trading.