---
title: "Register a webhook alert"
method: POST
path: "/alerts"
tags: ["Alerts"]
---

# Register a webhook alert

`POST /alerts`

Create price, volume, whale, or launch alerts that POST to your webhook when triggered.

## Request body

- object
  - `type` 'price' | 'volume' | 'whale' | 'launch', required
  - `condition` string, required — Trigger condition (e.g. SOL > 200)
  - `webhookUrl` string, uri, required
  - `expiryHours` integer

## Response `200`

Alert created

- AlertResponse
  - `alert_id` string
  - `created` string, date-time
  - `expires` string, date-time
  - `status` 'active' | 'triggered' | 'expired'

## Other responses

- `402` — Payment required

---

[API](https://skmtc.net/solsigs/apis/solsigs-solana-data-apis-for-ai-agents.md) · [All operations](https://skmtc.net/solsigs/apis/solsigs-solana-data-apis-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solsigs/solsigs-solana-data-apis-for-ai-agents/revisions/296e44870ad2/schema)