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
我该使用它吗
质量与安全性
发现（3）
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domain在 compare_gpu_prices 中
- MEDIUMTool description contains URL to non-standard domain在 optimize_stack 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"lantern-works-deals": {
"command": "uvx",
"args": [
"lantern-works-deals-mcp"
]
}
}
}可运行的软件包
0.3.26stdio远程端点
https://lantern-works-mcp.lantern-works.workers.dev/mcp?ref=mcp-registrystreamable-http它能做什么
工具清单
工具（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.
输入模式
{
"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"
]
}输出模式
{
"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).
输入模式
{
"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"
}
}
}输出模式
{
"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/.
输入模式
{
"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"
}
}
}输出模式
{
"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.
输入模式
{
"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"
}
}
}输出模式
{
"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.
输入模式
{
"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"
]
}输出模式
{
"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.
输入模式
{
"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"
}
}
}输出模式
{
"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.
输入模式
{
"type": "object",
"properties": {
"ids": {
"type": "string"
},
"mode": {
"type": "string",
"default": "full"
}
},
"required": [
"ids"
]
}输出模式
{
"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.
输入模式
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"mode": {
"type": "string",
"default": "full"
}
},
"required": [
"id"
]
}输出模式
{
"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.
输入模式
{
"type": "object",
"properties": {
"webhook_url": {
"type": "string"
},
"email": {
"type": "string"
}
},
"required": [
"webhook_url"
]
}输出模式
{
"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.
输入模式
{
"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"
]
}输出模式
{
"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.
输入模式
{
"type": "object",
"properties": {
"api_key": {
"type": "string"
}
}
}输出模式
{
"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.
输入模式
{
"type": "object",
"properties": {
"watch_id": {
"type": "string"
},
"api_key": {
"type": "string"
}
},
"required": [
"watch_id"
]
}输出模式
{
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
},
"required": [
"ok"
],
"additionalProperties": true
}社区
证据