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 domaincompare_gpu_prices에서
- MEDIUMTool description contains URL to non-standard domainoptimize_stack에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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
}커뮤니티
증거