FORESIGHT · API PLAYGROUND

Foresight

Docs that double as proof.

The public endpoints below return current JSON with source_state metadata. The right rail shows an example attestation for the verification workflow so agents can separate API data from signed proof.

FORESIGHT · GET

Score a paper

GET/api/v1/foresight/score

Live score decomposition plus the latest valid frozen prediction.

Returns the live signal-fusion score, viability breakdown, and the latest valid frozen public prediction (if one exists). Use this endpoint to inspect the model's reasoning for one paper.

PARAMETERS

NAME	TYPE	REQUIRED	DESCRIPTION
arxiv_id	string	required	ArXiv paper identifier, e.g. 2305.16311.

RESPONSE SHAPE

{ arxiv_id, viability_score, signal_fusion_score, breakdown, frozen_prediction|null, live }. live.source_state tells callers whether the score came from live, stale, seeded, or unavailable data.

EXAMPLE ATTESTATION

Example attestation for the verification flow, not the live endpoint response body. Copy the request to inspect the live JSON separately.

curl -s "https://sciencetostartup.com/api/v1/foresight/score?arxiv_id=2305.16311" \
  -H "Accept: application/json" | jq .

EXAMPLE ATTESTATION

{
  "alg": "Ed25519",
  "kid": "foresight-lineage-dev-2026-05-23",
  "hash": "8a37f63b49d84e23de94cbb4cf708750e503425b85b81f2e5a3a9fd7e851e887",
  "signature_b64": "Ythc/nYnJhSuNHLldWC+F6Q/8dCE/ZkqlSQlFo713aG9k7VnpEu9pRJ7f0SLDqf84IxdjY0Sb0eUIiothoknAQ==",
  "record": {
    "batch": "fs-batch-0142",
    "brier_score": 0.082,
    "calibration_rmse": 0.088,
    "frozen_at": "2026-05-22T00:00:00.000Z",
    "model": "fs-v0.4.2",
    "predictions_count": 1847,
    "registry_uri": "/foresight/v0.4.2"
  }
}

MACHINE-READABLE PROOFThe machine track ships alongside the human docs:

Batch: fs-batch-0142 · As of: 2026-06-08

Use This Via API or MCP

Full Foresight API documentation

The five public /api/v1/foresight endpoints listed here are unauthenticated and CORS-enabled. Verification-only surfaces are separate from this REST inventory.

Start here REST guide MCP guide

NAME

TYPE

REQUIRED

DESCRIPTION

arxiv_id

string

required

ArXiv paper identifier, e.g. 2305.16311.

{ "alg": "Ed25519", "kid": "foresight-lineage-dev-2026-05-23", "hash": "8a37f63b49d84e23de94cbb4cf708750e503425b85b81f2e5a3a9fd7e851e887", "signature_b64": "Ythc/nYnJhSuNHLldWC+F6Q/8dCE/ZkqlSQlFo713aG9k7VnpEu9pRJ7f0SLDqf84IxdjY0Sb0eUIiothoknAQ==", "record": { "batch": "fs-batch-0142", "brier_score": 0.082, "calibration_rmse": 0.088, "frozen_at": "2026-05-22T00:00:00.000Z", "model": "fs-v0.4.2", "predictions_count": 1847, "registry_uri": "/foresight/v0.4.2" } }