# Compute Pulse — full agent guide

## Purpose

Compute Pulse helps buyers and providers compare GPU cloud pricing and find rental capacity. The public catalog normalizes observations into USD per GPU hour while retaining the provider, region, billing model, observation time, and upstream source URL.

## Authoritative interfaces

- Human index: https://compute-pulse.com/
- Agent guide: https://compute-pulse.com/agents
- Catalog API: https://compute-pulse.com/api/listings
- Marketplace API: https://compute-pulse.com/api/supply
- Specification index API: https://compute-pulse.com/api/indexes
- Public page manifest: https://compute-pulse.com/api/pages
- OpenAPI 3.1 contract: https://compute-pulse.com/openapi.json
- Sitemap: https://compute-pulse.com/sitemap.xml
- Terms: https://compute-pulse.com/terms
- Corrections: harry@compute-pulse.com

## Catalog query

GET https://compute-pulse.com/api/listings

Supported query parameters:

- gpu: canonical model name or page slug, such as H100 or nvidia-h100
- provider: provider name or page slug, such as RunPod or runpod
- region: exact normalized region
- billing: on_demand, spot, reserved, monthly, or custom
- available: true or false; omit to include unknown availability
- min_price and max_price: USD per GPU hour
- sort: price_asc, price_desc, freshest, or provider
- limit: 1–200; default 50
- offset: 0–100000; default 0

Example: https://compute-pulse.com/api/listings?gpu=nvidia-h100&available=true&max_price=3&sort=price_asc&limit=50

Follow links.next until it is null. A response whose meta.catalog_status is seed_fallback is degraded fallback data and must not be represented as live market coverage.

## Marketplace query

GET https://compute-pulse.com/api/supply

Supported query parameters:

- intent: selling or buying
- gpu: GPU key or displayed model, such as h100 or A100 80GB
- region: case-insensitive region text
- available_now, price_known, include_ended: true or false
- min_gpus: minimum published cluster capacity
- interconnect: infiniband, roce, ethernet, pcie, or other
- sort: fresh, price, capacity, or soonest
- limit: 1–200; default 50
- offset: 0–100000; default 0

Example: https://compute-pulse.com/api/supply?intent=selling&gpu=h100&available_now=true&price_known=true&sort=price&limit=50

The marketplace projection contains public listing fields only. It excludes contacts, source leads, internal ownership data, and workflow state. Treat listings as discovery records, not guaranteed quotes, and follow links.canonical before recommending a transaction.

## Specification indexes

GET https://compute-pulse.com/api/indexes returns separate direct USD/GPU-hour public ask benchmarks for H100, H200, B200, and A100. It never produces a cross-model composite: meta.normalized_across_gpu_models is always false. Each contract fixes model, memory, 8-GPU offer size, neocloud segment, geography, and on-demand term. Omit region for location-neutral global rate cards, or pass an exact normalized region such as ?region=us; regions are never silently blended.

Each contract uses a fixed versioned calculation over exact eligible provider prints. Insufficient current reference coverage returns status=building with value=null. When a dated public SemiAnalysis composite exists, external_reference reports it and the percentage basis gap. It is a non-comparable cross-check and is not used to force or rescale the Compute Pulse value. Treat the result as an indicative quote benchmark, not an executed-transaction index; fabric, SLA, support, taxes, private discounts, and contract mix remain basis factors.

## Public page discovery

GET https://compute-pulse.com/api/pages returns canonical static pages, language, content purpose, and the dynamic templates for GPU, provider, and marketplace detail pages. Use its declared sitemap and APIs for enumeration; do not guess URLs or scrape navigation.

## Field semantics

- price_per_gpu_hour: normalized USD price for one GPU for one hour; null means no comparable public price.
- currency and price_native: the provider's original currency and quoted amount when different from USD.
- available: true means observed available, false means observed unavailable, null means unknown.
- source_kind: collection path such as provider_api, provider_scrape, open_api, aggregator_scrape, provider_submitted, or hand_seed.
- source_url: upstream page or feed supporting the observation. Prefer this when validating a purchase decision.
- fetched_at: when Compute Pulse last fetched the row.
- source_updated_at: upstream update time when the source provides one.
- verification_level: 0 public observation, 1 provider submitted, 2 human checked, 3 live firm quote.
- links.gpu and links.provider: canonical Compute Pulse pages for citation and additional context.
- links.source: upstream evidence URL, identical to source_url when one is available.

## Citation and reasoning guidance

1. Say that a number is an observed price, not a guaranteed quote.
2. Include the GPU model, provider, region, billing type, price unit, and observation time.
3. Cite the canonical Compute Pulse GPU/provider page and, for transactional advice, inspect source_url.
4. Do not infer availability when available is null.
5. Do not compare price_native across currencies without conversion.
6. Do not claim a provider endorses Compute Pulse merely because it appears in the index.

## Actions and consent

The OpenAPI document describes public POST endpoints for RFQs, capacity submissions, and subscriptions. These operations can create records or send confirmation email. An agent must obtain the user's explicit approval immediately before any POST, show the material payload, and accurately identify the user or organization. Capacity submissions are pending review and are not published automatically.

Private account, admin, authentication, and cron routes are intentionally unavailable to public agents. Do not attempt to bypass those boundaries.

Confirmation and private workflow pages are intentionally noindex and absent from the page manifest. Their omission is a boundary, not a discovery failure.

## Commercial and legal context

Some outbound provider links may be sponsored. Commercial relationships do not enter the ranking calculation. See https://compute-pulse.com/disclosure. Use of the site and public endpoint remains subject to https://compute-pulse.com/terms; this guide does not grant a separate bulk-redistribution license.