Docs

Public API reference

Status: Proposed product contracts (/v1/quote, /v1/panel).
First design partners may receive CSV / ranked file or a stub embed before public GA. Schemas below are the intended JSON surface for docs and LOIs, not a live open endpoint today.

Auth (planned): Authorization: Bearer <api_key>
Access controls (planned): rate limits, entitlements, no raw tape / history dump endpoints.

6.1 `POST /v1/quote`

Request a workload-aware Quote: listed control ranking + PIS-gated TRAC ranking.

Request body

{
  "hours": 48,
  "data_gb": 500,
  "lane": "p2p_host",
  "gpu_type": null,
  "pis_threshold": 70,
  "workload_profile": "llm_fine_tuning",
  "source": "live"
}

Field	Type	Notes
`hours`	number	Task duration
`data_gb`	number	Transfer volume for egress term
`lane`	string \| null	`p2p_host` \| `macro_catalog` \| `regional_managed` \| omit for panel-wide
`gpu_type`	string \| null	Optional filter
`pis_threshold`	integer	Default `70` (operational filter; see §3.2)
`workload_profile`	string	`llm_fine_tuning` \| `batch_inference` \| `custom`
`source`	string	`live` \| `hybrid` \| `sample` (demo)

Response (illustrative)

{
  "as_of": "2026-08-10T12:00:00Z",
  "methodology_version": "v1",
  "workload": { "hours": 48, "data_gb": 500, "lane": "p2p_host" },
  "gate": { "pis_threshold": 70, "passers": 12, "below": 8 },
  "survivors": [
    {
      "listing_id": "ex_001",
      "lane": "p2p_host",
      "listed_job_cost": 96.0,
      "trac": 128.4,
      "delta": 32.4,
      "pis": 82,
      "sir": 0.18,
      "stability": "High",
      "signal_coverage": 71.5,
      "fee_lineage": {
        "egress": "observed",
        "base": "listed_spot",
        "risk_premium": "model_v1"
      },
      "composition": {
        "base_cost": 96.0,
        "egress_loss": 12.0,
        "risk_premium": 20.4
      }
    }
  ]
}

cURL (illustrative, not live)

curl -sS -X POST "https://api.markcompute.com/v1/quote" \
  -H "Authorization: Bearer $MARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hours":48,"data_gb":500,"lane":"p2p_host","pis_threshold":70}'

6.2 `GET /v1/panel`

Market observatory snapshot: CireX family + capacity context (aggregated, not a tape download).

Response (illustrative)

{
  "as_of": "2026-08-10T12:00:00Z",
  "methodology_version": "v1",
  "indices": {
    "cirex": 41,
    "cix": 18.2,
    "basis_median": 0.27
  },
  "capacity": {
    "total_gpus": 12500,
    "execution_risk_gpus": 2275
  },
  "stress": {
    "scenario": "baseline",
    "hhi": 0.12
  }
}

6.3 Errors (planned)

HTTP	Meaning
400	Invalid / workload validation
401	Missing or invalid API key
404	Unknown route or resource
429	Rate limited
503	Tape / upstream temporarily unavailable

6.4 Forward

/v1/forward/* is reserved. Not documented as live.

6.1 POST /v1/quote

6.2 GET /v1/panel

6.3 Errors (planned)

6.4 Forward

6.1 `POST /v1/quote`

6.2 `GET /v1/panel`