Lantern Works GPU Prices: daily GPU rental price comparison
GPU rental prices checked daily, with price history and change feed; stack optimizer; AI-infra deals
¿Debería usar esto?
Calidad y seguridad
Hallazgos (3)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domainen compare_gpu_prices
- MEDIUMTool description contains URL to non-standard domainen optimize_stack
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"lantern-works-deals": {
"command": "uvx",
"args": [
"lantern-works-deals-mcp"
]
}
}
}Paquetes ejecutables
0.3.26stdioPuntos de conexión remotos
https://lantern-works-mcp.lantern-works.workers.dev/mcp?ref=mcp-registrystreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (12)
🟢compare_gpu_prices(gpu, limit, include_history, on_demand_only, include_reserved, ...)
Compare tracked GPU rental prices for one model (e.g. 'H100', 'A100 SXM', 'RTX 4090', 'L40S'), cheapest first. If a result looks wrong, give the user its report_issue_url. Same data as https://thelanternworks.com/api/v1/gpu-prices.json. Sorted by hourly_usd ascending; each result has source_url and checked_at. 'Cheapest' means cheapest among tracked providers, not the whole market. limit 1-25. Unknown model returns not_found listing tracked models. Each result has tier_class: on-demand | community | marketplace | interruptible (spot/preemptible) | reserved | dedicated-monthly. Reserved (reservation/commitment 'starting from') rates are left out unless include_reserved=true, and even then they are never reported as cheapest. The cheapest overall can be spot or community capacity; on_demand_only=true keeps only on-demand rates, and the summary names the cheapest on-demand rate when the overall cheapest isn't. include_history=true adds each result's price_history (daily-snapshot change points) and history.recent_changes (price changes for this model among tracked providers, last 30 days) from /api/v1/gpu-prices/history.json. Each result has data_age_hours (hours since its price was last verified), degraded (> 48 h) and stale (> 7 days). max_data_age_hours (optional) drops older rates; excluded_too_old reports how many were dropped.
Esquema de entrada
{
"type": "object",
"properties": {
"gpu": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 10
},
"include_history": {
"type": "boolean",
"default": false
},
"on_demand_only": {
"type": "boolean",
"default": false
},
"include_reserved": {
"type": "boolean",
"default": false
},
"max_data_age_hours": {
"type": "number",
"default": null
},
"mode": {
"type": "string",
"default": "full"
}
},
"required": [
"gpu"
]
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"brief",
"full"
]
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"invalid_argument",
"invalid_cursor",
"cursor_expired",
"not_found",
"feed_unavailable",
"feed_invalid",
"upstream_unavailable",
"internal_error"
]
},
"message": {
"type": "string"
}
}
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"advertiser",
"gpu",
"hourly_usd",
"source_url",
"rank",
"rate_id"
],
"properties": {
"rate_id": {
"type": "string",
"pattern": "^r_[0-9a-f]{12}$"
},
"report_issue_url": {
"type": [
"string",
"null"
]
},
"region": {
"type": [
"string",
"null"
]
},
"availability": {
"type": [
"object",
"null"
],
"properties": {
"status": {
"type": [
"string",
"null"
]
},
"in_stock": {
"type": [
"boolean",
"null"
]
},
"checked_at": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"basis": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
}
}
},
"in_stock": {
"type": [
"boolean",
"null"
]
}
}
}
}
},
"required": [
"ok"
],
"additionalProperties": true,
"if": {
"properties": {
"ok": {
"const": false
}
}
},
"then": {
"required": [
"ok",
"error"
]
},
"else": {
"required": [
"ok",
"mode",
"gpu",
"summary",
"count",
"results"
],
"not": {
"required": [
"error"
]
}
}
}🟢get_price_changes(since, gpu, limit, cursor, kinds, ...)
GPU rental price changes among tracked providers, each with old/new hourly price, change_pct, direction, the vendor source_url, a stable event_id (dedupe key) and rate_id. since: 'YYYY-MM-DD' returns every change on or after that date, newest first (daily snapshots in /api/v1/gpu-prices/history.json); omitted returns the latest day's moves (/api/v1/gpu-price-changes.json). cursor: pass next_cursor from a previous call to get every change after it, oldest first, with has_more; loop until has_more is false, and store next_cursor only after processing (a watcher never misses or repeats events). error cursor_expired means re-sync with since and dedupe by event_id. kinds: optional subset of down, up, new, removed, same. gpu: optional model filter (substring, e.g. 'H100'). limit 1-200. Includes data_checked_at and next_refresh_utc (prices refresh daily at about 10:23 UTC).
Esquema de entrada
{
"type": "object",
"properties": {
"since": {
"type": "string",
"default": null
},
"gpu": {
"type": "string",
"default": null
},
"limit": {
"type": "integer",
"default": 50
},
"cursor": {
"type": "string",
"default": null
},
"kinds": {
"type": "array",
"items": {
"type": "string"
},
"default": null
},
"mode": {
"type": "string",
"default": "full"
}
}
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"brief",
"full"
]
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"invalid_argument",
"invalid_cursor",
"cursor_expired",
"not_found",
"feed_unavailable",
"feed_invalid",
"upstream_unavailable",
"internal_error"
]
},
"message": {
"type": "string"
}
}
},
"changes": {
"type": "array",
"items": {
"type": "object",
"required": [
"vendor",
"gpu",
"direction"
],
"properties": {
"event_id": {
"type": [
"string",
"null"
]
},
"rate_id": {
"type": [
"string",
"null"
]
},
"key": {
"type": [
"string",
"null"
]
},
"seq": {
"type": [
"integer",
"null"
]
},
"snapshot_id": {
"type": [
"string",
"null"
]
}
}
}
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"has_more": {
"type": [
"boolean",
"null"
]
},
"last_seq": {
"type": [
"integer",
"null"
]
}
},
"required": [
"ok"
],
"additionalProperties": true,
"if": {
"properties": {
"ok": {
"const": false
}
}
},
"then": {
"required": [
"ok",
"error"
]
},
"else": {
"required": [
"ok",
"mode",
"total",
"count",
"changes"
],
"not": {
"required": [
"error"
]
}
}
}🟢optimize_stack(scrape_pages, scrape_pages_js, proxy_gb, emails_sent, search_queries, ...)
Cheapest suitable stack among tracked providers for monthly needs (set the quantities you need, rest 0). scrape_pages: pages/month without JS rendering. scrape_pages_js: pages/month needing JS rendering. proxy_gb: residential proxy GB/month. emails_sent: transactional emails/month. search_queries: search API queries/month. gpu_hours: GPU-hours/month (1 GPU), optionally gpu_model e.g. 'H100', 'A100', 'RTX 4090'. Each line has the chosen plan, monthly_cost_usd, calc, vendor quote, source_url, checked_at and assumptions, plus alternatives. A vendor price that isn't published is 'unknown' (never estimated). manual_signup_only=true means a human must sign up (never automate it); exclude_manual_signup=true drops those plans. Same data as https://thelanternworks.com/api/v1/stack-pricing.json and /tools/stack-optimizer/.
Esquema de entrada
{
"type": "object",
"properties": {
"scrape_pages": {
"type": "integer",
"default": 0
},
"scrape_pages_js": {
"type": "integer",
"default": 0
},
"proxy_gb": {
"type": "number",
"default": 0
},
"emails_sent": {
"type": "integer",
"default": 0
},
"search_queries": {
"type": "integer",
"default": 0
},
"gpu_hours": {
"type": "number",
"default": 0
},
"gpu_model": {
"type": "string",
"default": null
},
"exclude_manual_signup": {
"type": "boolean",
"default": false
},
"mode": {
"type": "string",
"default": "full"
}
}
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"brief",
"full"
]
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"invalid_argument",
"invalid_cursor",
"cursor_expired",
"not_found",
"feed_unavailable",
"feed_invalid",
"upstream_unavailable",
"internal_error"
]
},
"message": {
"type": "string"
}
}
},
"lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"choice": {
"type": [
"object",
"null"
],
"properties": {
"rate_id": {
"type": "string",
"pattern": "^r_[0-9a-f]{12}$"
},
"availability": {
"type": [
"object",
"null"
],
"properties": {
"status": {
"type": [
"string",
"null"
]
},
"in_stock": {
"type": [
"boolean",
"null"
]
},
"checked_at": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"basis": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
}
}
},
"in_stock": {
"type": [
"boolean",
"null"
]
},
"availability_note": {
"type": [
"string",
"null"
]
}
},
"required": [
"rate_id"
]
},
"availability_note": {
"type": [
"string",
"null"
]
},
"alternatives": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"rate_id": {
"type": "string",
"pattern": "^r_[0-9a-f]{12}$"
},
"availability": {
"type": [
"object",
"null"
],
"properties": {
"status": {
"type": [
"string",
"null"
]
},
"in_stock": {
"type": [
"boolean",
"null"
]
},
"checked_at": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"basis": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
}
}
},
"in_stock": {
"type": [
"boolean",
"null"
]
},
"availability_note": {
"type": [
"string",
"null"
]
}
},
"required": [
"rate_id"
]
}
}
},
"required": [
"status"
]
}
},
"quote_id": {
"type": "string",
"pattern": "^q_[0-9a-f]{20}$"
},
"issued_at": {
"type": "string",
"format": "date-time"
},
"quote_basis": {
"type": "object"
}
},
"required": [
"ok"
],
"additionalProperties": true,
"if": {
"properties": {
"ok": {
"const": false
}
}
},
"then": {
"required": [
"ok",
"error"
]
},
"else": {
"required": [
"ok",
"mode",
"lines",
"total_monthly_usd",
"total_is_complete",
"quote_id",
"issued_at"
],
"not": {
"required": [
"error"
]
}
}
}🟢optimize_agent_stack(description, workload, gpu_hours, gpu_model, model_size_b, ...)
Estimate a monthly stack cost from a short description of the agent being built. description: free text, e.g. 'scrapes 20k JS pages/month via 5 GB residential proxies, 3k search queries, summarizes with an LLM, budget $300/mo'. Parsed deterministically (keywords/regex, no LLM) into components: gpu, scraping, proxy, search, llm_api, email, hosting, database, monitoring. Optional fields override the parse: gpu_hours (GPU-hours/month), gpu_model ('H100', 'A100', 'RTX 4090'), model_size_b (billions of params; sets a minimum VRAM using FP16 x 1.2), scrape_pages, js_rendering, proxy_gb, search_queries, emails_sent, llm_api, monthly_budget_usd. Each component gets the cheapest option with a cited price among tracked providers, with calc, source_url, verified_at, referral_disclosure (set when the link is a referral link) and manual-signup notes. Components with no cited price say 'no sourced price tracked' (nothing is estimated). Totals show the math and say whether they are complete. Pulled listings are excluded. Every option has data_age_hours, degraded (> 48 h) and stale (> 7 days); max_data_age_hours drops older options (excluded_too_old counts them). Same data as optimize_stack, compare_gpu_prices and the deal feed.
Esquema de entrada
{
"type": "object",
"properties": {
"description": {
"type": "string",
"default": ""
},
"workload": {
"type": "string",
"default": null
},
"gpu_hours": {
"type": "number",
"default": null
},
"gpu_model": {
"type": "string",
"default": null
},
"model_size_b": {
"type": "number",
"default": null
},
"scrape_pages": {
"type": "number",
"default": null
},
"js_rendering": {
"type": "boolean",
"default": null
},
"proxy_gb": {
"type": "number",
"default": null
},
"search_queries": {
"type": "number",
"default": null
},
"emails_sent": {
"type": "number",
"default": null
},
"llm_api": {
"type": "boolean",
"default": null
},
"monthly_budget_usd": {
"type": "number",
"default": null
},
"exclude_manual_signup": {
"type": "boolean",
"default": false
},
"max_data_age_hours": {
"type": "number",
"default": null
},
"mode": {
"type": "string",
"default": "full"
}
}
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"brief",
"full"
]
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"invalid_argument",
"invalid_cursor",
"cursor_expired",
"not_found",
"feed_unavailable",
"feed_invalid",
"upstream_unavailable",
"internal_error"
]
},
"message": {
"type": "string"
}
}
},
"lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"choice": {
"type": [
"object",
"null"
],
"properties": {
"rate_id": {
"type": "string",
"pattern": "^r_[0-9a-f]{12}$"
},
"availability": {
"type": [
"object",
"null"
],
"properties": {
"status": {
"type": [
"string",
"null"
]
},
"in_stock": {
"type": [
"boolean",
"null"
]
},
"checked_at": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"basis": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
}
}
},
"in_stock": {
"type": [
"boolean",
"null"
]
},
"availability_note": {
"type": [
"string",
"null"
]
}
},
"required": [
"rate_id"
]
},
"availability_note": {
"type": [
"string",
"null"
]
},
"alternatives": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"rate_id": {
"type": "string",
"pattern": "^r_[0-9a-f]{12}$"
},
"availability": {
"type": [
"object",
"null"
],
"properties": {
"status": {
"type": [
"string",
"null"
]
},
"in_stock": {
"type": [
"boolean",
"null"
]
},
"checked_at": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"basis": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
}
}
},
"in_stock": {
"type": [
"boolean",
"null"
]
},
"availability_note": {
"type": [
"string",
"null"
]
}
},
"required": [
"rate_id"
]
}
}
},
"required": [
"component",
"status"
]
}
},
"quote_id": {
"type": "string",
"pattern": "^q_[0-9a-f]{20}$"
},
"issued_at": {
"type": "string",
"format": "date-time"
},
"quote_basis": {
"type": "object"
}
},
"required": [
"ok"
],
"additionalProperties": true,
"if": {
"properties": {
"ok": {
"const": false
}
}
},
"then": {
"required": [
"ok",
"error"
]
},
"else": {
"required": [
"ok",
"mode",
"lines",
"monthly_estimate_usd",
"estimate_is_complete",
"quote_id",
"issued_at"
],
"not": {
"required": [
"error"
]
}
}
}🟢estimate_job_cost(gpu_family, gpus_per_job, job_hours, work_units, throughput_units_per_gpu_hour, ...)
Cost of one GPU job (not cost per hour) among tracked providers, cheapest compute subtotal first. You supply the duration: job_hours, OR work_units plus throughput_units_per_gpu_hour from your own benchmark (job_hours = work_units / (throughput x gpus_per_job)). If you give workload + work_units but no throughput, a directly applicable published figure (closed-division MLPerf Inference, exact GPU variant, inference only) is used: throughput_basis='published_benchmark' with throughput_source {url, quote, date, benchmark, derived, caveats}; your throughput always wins. Otherwise not_found 'missing: throughput for {gpu}'. Whole-instance billing: instances = ceil(gpus_per_job / gpus_per_instance), all allocated GPUs billed (9 GPUs on an 8-GPU-only offer bill 16). Reserved and held-stale rates are never ranked; spot/interruptible only if allow_interruptible. Each result has rate_id, source_url, verified_at, data_age_hours/degraded/stale. Response has assumptions, citations, missing_costs, budget_verdict (unresolved: extras unknown) and a quote_id. Compute subtotal only.
Esquema de entrada
{
"type": "object",
"properties": {
"gpu_family": {
"type": "string"
},
"gpus_per_job": {
"type": "integer"
},
"job_hours": {
"type": "number",
"default": null
},
"work_units": {
"type": "number",
"default": null
},
"throughput_units_per_gpu_hour": {
"type": "number",
"default": null
},
"workload": {
"type": "string",
"default": null
},
"allow_interruptible": {
"type": "boolean",
"default": false
},
"min_vram_gb": {
"type": "integer",
"default": null
},
"runs_per_month": {
"type": "number",
"default": null
},
"top_n": {
"type": "integer",
"default": 5
},
"max_data_age_hours": {
"type": "number",
"default": null
},
"mode": {
"type": "string",
"default": "full"
}
},
"required": [
"gpu_family",
"gpus_per_job"
]
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"brief",
"full"
]
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"invalid_argument",
"invalid_cursor",
"cursor_expired",
"not_found",
"feed_unavailable",
"feed_invalid",
"upstream_unavailable",
"internal_error"
]
},
"message": {
"type": "string"
}
}
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"rank",
"rate_id",
"vendor",
"allocated_gpus",
"instances",
"compute_subtotal_usd",
"source_url"
],
"properties": {
"rate_id": {
"type": "string",
"pattern": "^r_[0-9a-f]{12}$"
},
"data_age_hours": {
"type": [
"number",
"null"
]
},
"degraded": {
"type": [
"boolean",
"null"
]
},
"stale": {
"type": [
"boolean",
"null"
]
},
"availability": {
"type": [
"object",
"null"
],
"properties": {
"status": {
"type": [
"string",
"null"
]
},
"in_stock": {
"type": [
"boolean",
"null"
]
},
"checked_at": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"basis": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
}
}
},
"in_stock": {
"type": [
"boolean",
"null"
]
},
"availability_note": {
"type": [
"string",
"null"
]
}
}
}
},
"quote_id": {
"type": "string",
"pattern": "^q_[0-9a-f]{20}$"
},
"issued_at": {
"type": "string",
"format": "date-time"
},
"quote_basis": {
"type": "object"
},
"budget_verdict": {
"type": "string",
"enum": [
"unresolved",
"within",
"over"
]
}
},
"required": [
"ok"
],
"additionalProperties": true,
"if": {
"properties": {
"ok": {
"const": false
}
}
},
"then": {
"required": [
"ok",
"error"
]
},
"else": {
"required": [
"ok",
"mode",
"gpu_family",
"requested_gpus",
"job_hours",
"count",
"results",
"assumptions",
"citations",
"missing_costs",
"budget_verdict",
"quote_id",
"issued_at"
],
"not": {
"required": [
"error"
]
}
}
}🟢search_deals(query, category, offer_type, max_price, tags, ...)
Search agent work-stack deals (compute, search, email, unblock, hosting...). offer_type: verified_discount | listed_discount (not confirmed; verified_at null) | free_tier | trial | standard_referral | credit_only_referral. max_price excludes deals with unknown price. limit 1-25. Pass next_cursor back as cursor to page.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"default": null
},
"category": {
"type": "string",
"default": null
},
"offer_type": {
"type": "string",
"default": null
},
"max_price": {
"type": "number",
"default": null
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"default": null
},
"limit": {
"type": "integer",
"default": 10
},
"cursor": {
"type": "string",
"default": null
},
"mode": {
"type": "string",
"default": "full"
}
}
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"brief",
"full"
]
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"invalid_argument",
"invalid_cursor",
"cursor_expired",
"not_found",
"feed_unavailable",
"feed_invalid",
"upstream_unavailable",
"internal_error"
]
},
"message": {
"type": "string"
}
}
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
]
}
}
},
"required": [
"ok"
],
"additionalProperties": true,
"if": {
"properties": {
"ok": {
"const": false
}
}
},
"then": {
"required": [
"ok",
"error"
]
},
"else": {
"required": [
"ok",
"mode",
"total",
"count",
"results"
],
"not": {
"required": [
"error"
]
}
}
}🟢compare_deals(ids, mode)
Compare 2-5 deals side by side (price, unit, offer type, code, verification), best value first.
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"type": "string"
},
"mode": {
"type": "string",
"default": "full"
}
},
"required": [
"ids"
]
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"brief",
"full"
]
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"invalid_argument",
"invalid_cursor",
"cursor_expired",
"not_found",
"feed_unavailable",
"feed_invalid",
"upstream_unavailable",
"internal_error"
]
},
"message": {
"type": "string"
}
}
},
"deals": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
]
}
}
},
"required": [
"ok"
],
"additionalProperties": true,
"if": {
"properties": {
"ok": {
"const": false
}
}
},
"then": {
"required": [
"ok",
"error"
]
},
"else": {
"required": [
"ok",
"mode",
"deals"
],
"not": {
"required": [
"error"
]
}
}
}🟢get_deal(id, mode)
Get one deal's public record by id, including redeem_url and agent_instructions.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"mode": {
"type": "string",
"default": "full"
}
},
"required": [
"id"
]
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"brief",
"full"
]
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"enum": [
"invalid_argument",
"invalid_cursor",
"cursor_expired",
"not_found",
"feed_unavailable",
"feed_invalid",
"upstream_unavailable",
"internal_error"
]
},
"message": {
"type": "string"
}
}
}
},
"required": [
"ok"
],
"additionalProperties": true,
"if": {
"properties": {
"ok": {
"const": false
}
}
},
"then": {
"required": [
"ok",
"error"
]
},
"else": {
"required": [
"ok",
"mode",
"id"
],
"not": {
"required": [
"error"
]
}
}
}🟡create_watch_key(webhook_url, email)
Hosted only, free, opt-in. Register a webhook for GPU price alerts and get an api_key plus a webhook signing secret (both shown ONCE; store them). webhook_url must be public https. email is optional contact only (no mail is sent). No payment. Stored: a hash of the key, the webhook URL, optional email, your watches and per-key counts.
Esquema de entrada
{
"type": "object",
"properties": {
"webhook_url": {
"type": "string"
},
"email": {
"type": "string"
}
},
"required": [
"webhook_url"
]
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
},
"required": [
"ok"
],
"additionalProperties": true
}🟡watch_price(gpu, max_hourly_usd, region, kinds, api_key)
Hosted only. Alert your webhook (signed POST) after the daily refresh when a tracked rate for `gpu` crosses at or below max_hourly_usd, or a change of a watched kind (down/up/new; default down) lands at or below it. region: optional code from availability.available_regions (rates that publish no region never match). Each event is delivered at most once per watch (dedupe on event_id). Pass api_key or an Authorization: Bearer header.
Esquema de entrada
{
"type": "object",
"properties": {
"gpu": {
"type": "string"
},
"max_hourly_usd": {
"type": "number"
},
"region": {
"type": "string"
},
"kinds": {
"type": "array",
"items": {
"type": "string",
"enum": [
"down",
"up",
"new"
]
}
},
"api_key": {
"type": "string"
}
},
"required": [
"gpu",
"max_hourly_usd"
]
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
},
"required": [
"ok"
],
"additionalProperties": true
}🟢list_watches(api_key)
Hosted only. Your watches and per-key alert counts.
Esquema de entrada
{
"type": "object",
"properties": {
"api_key": {
"type": "string"
}
}
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
},
"required": [
"ok"
],
"additionalProperties": true
}🔴delete_watch(watch_id, api_key)
Hosted only. Delete one of your watches by watch_id.
Esquema de entrada
{
"type": "object",
"properties": {
"watch_id": {
"type": "string"
},
"api_key": {
"type": "string"
}
},
"required": [
"watch_id"
]
}Esquema de salida
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
},
"required": [
"ok"
],
"additionalProperties": true
}Comunidad
Evidencia