---
title: "Probability surface — options x prediction markets"
method: GET
path: "/v1/surface/{metal}"
tags: ["surface"]
---

# Probability surface — options x prediction markets

`GET /v1/surface/{metal}`

§5.3 — latest snapshot for one metal at one horizon (or the default
horizon from the §5.3b index when `horizon` is omitted). Stale-engine
honesty: a snapshot older than surface_serve_max_age_seconds is still
served with its true snapshot_age_seconds — never 404 on staleness.

## Path parameters

- `metal` string, required

## Query parameters

- `horizon` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `403` — plan_gated — requires the Pro tier or higher.
- `404` — unknown_metal, unknown_horizon, or no data yet.
- `422` — invalid_horizon — must be an ISO date (YYYY-MM-DD).

---

[API](https://skmtc.net/goldprice/apis/gold-api.md) · [All operations](https://skmtc.net/goldprice/apis/gold-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goldprice/gold-api/revisions/7885a141754c/schema)