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
}社群
證據