{"uid":"cap_CQHM5VCfhEHczWqZ6Wj_m","slug":"nythosx-price-trigger-webhook-7cde8ce5","name":"NythosX Price Trigger Webhook","description":"Arm a price trigger with webhook delivery. Arms a single-fire price trigger. NythosX checks the price every minute and POSTs a JSON event to your HTTPS webhook on the first crossing, signed with HMAC-SHA256 (header X-NythosX-Signature: sha256=<hex> over the raw body, key = returned secret). Expires after ttl_hours (default 168, max 720). Check status free at GET /api/v1/triggers/status?id=.","url":"https://market.nythosx.com/api/v1/triggers?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["symbol","direction","price","webhook_url"],"properties":{"price":{"type":"number","exclusiveMinimum":0},"symbol":{"enum":["BTC","SOL","ETH","BNB","LTC","ADA","XRP","XDC","NVDA","MSFT","AMZN","AAPL","USDPHP"],"type":"string"},"direction":{"enum":["above","below"],"type":"string"},"ttl_hours":{"type":"integer","default":168,"maximum":720,"minimum":1},"webhook_url":{"type":"string","format":"uri","description":"Public HTTPS URL"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"id":"trg_3f9a2c...","price":78000,"secret":"whsec_...","symbol":"BTC","current":81450.2,"direction":"below","expires_at":"2026-10-27T08:00:00.000Z","status_url":"https://market.nythosx.com/api/v1/triggers/status?id=trg_3f9a2c..."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ngK0yjtHBdfRQJu7cmSzR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Arms a single-fire price alert that POSTs a signed JSON event to your webhook when a crypto, stock, or forex asset crosses a specified price threshold","exampleAgentPrompt":"Set a price alert for BTC going below $78,000 and POST to https://myapp.example.com/hooks/price when it triggers — keep it active for 72 hours.","exampleUseCases":[{"title":"Crypto dip buy alert","prompt":"Arm a price trigger for ETH dropping below $2,800 and send a POST to https://tradingbot.example.com/webhook/eth-buy when it hits — I want it to stay active for 48 hours."},{"title":"Stock profit-taking alert","prompt":"Set up a one-time webhook alert for AAPL crossing above $220 — fire a POST to https://myportfolio.example.com/notify/aapl and keep monitoring for up to 168 hours."},{"title":"Automated trading workflow trigger","prompt":"I need NythosX to watch BTC and ping https://executor.example.com/orders/sell the moment it goes above $95,000 — sign the payload with HMAC so I can verify it, and let it expire after 24 hours."}],"resultDescription":"Returns a JSON object containing a unique trigger ID, the HMAC signing secret (whsec_...) to verify incoming webhook POSTs, the asset's current price, the expiry timestamp, and a status URL for free polling. When the price crosses the threshold, NythosX POSTs a signed JSON event to the provided webhook URL with an X-NythosX-Signature header.","failureModes":["Invalid or unsupported symbol — only BTC, ETH, SOL, BNB, LTC, ADA, XRP, XDC, NVDA, MSFT, AMZN, AAPL, USDPHP are accepted","webhook_url is not a public HTTPS URI — rejects non-HTTPS or unreachable URLs","price must be greater than 0 — zero or negative values rejected","ttl_hours out of range — must be 1–720","Payment of 0.02 USDC not fulfilled — x402 payment required","Trigger expires without crossing — fires once only, never re-arms automatically","Webhook endpoint unreachable at delivery time — trigger may silently fail to deliver"],"whenToPreferThis":"Choose this endpoint when you need a programmatic, one-shot price alert delivered to a machine-readable webhook rather than a human notification channel. It is ideal for agentic workflows where a downstream system (trading bot, order executor, event pipeline) needs to react automatically when a price level is crossed. Prefer this over polling-based approaches when you want sub-minute latency without maintaining your own price-feed connection. The HMAC signature makes it safe for security-sensitive downstream processing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T18:26:02.033Z","isFirstParty":false,"canonicalSlug":"nythosx-price-trigger-webhook-7cde8ce5"}