Alerts

Create a price or smart-money alert - 0 credits

GET

https://data.stalkchain.com

/api/v1/tools/stalkchain_alert_create

Create a price or smart-money alert - 0 credits › query Parameters

kind

string · enum · required

Enum values:

price_above

price_below

smart_money_buy

token

string · minLength: 20 · maxLength: 64 · required

Token address (mint on Solana, 0x… on EVM)

chain

string · enum

Default solana, or ethereum for 0x addresses

Enum values:

solana

ethereum

base

bsc

priceUsd

number · min: 0

Threshold in USD, for price_above / price_below

minTraders

integer · min: 2 · max: 20

smart_money_buy: how many tracked traders must buy. Default 2

channel

string · enum

email (the account's address, default) or webhook

Enum values:

webhook

webhookUrl

string · uri

https Discord, Slack or Telegram bot webhook URL, when channel is webhook

note

string · maxLength: 200

A short reminder of why the user set it

Create a price or smart-money alert - 0 credits › Responses

200

{ data, notes?, credits, meta }

No data returned

Create a price or smart-money alert - 0 credits

POST

https://data.stalkchain.com

/api/v1/tools/stalkchain_alert_create

Set up an alert that notifies the user once, by email or their own webhook (Discord, Slack or Telegram bot URL), when a token crosses a price or when several tracked traders buy it. Kinds: price_above / price_below (needs priceUsd), smart_money_buy (fires when at least minTraders tracked traders, default 2, buy the token within a few minutes). Needs the token's address: resolve a ticker first with stalkchain_fomo_search or stalkchain_token_prices_multichain. Chains: solana, ethereum, base, bsc. Alerts fire once and then switch off; checked about every 5 minutes; up to 20 active per account. Confirm the token, threshold and delivery with the user before calling. Returns the alert and the token's current price, so you can tell the user how far away the threshold is.

Create a price or smart-money alert - 0 credits › Request Body optional

kind

string · enum · required

Enum values:

price_above

price_below

smart_money_buy

token

string · minLength: 20 · maxLength: 64 · required

Token address (mint on Solana, 0x… on EVM)

chain

string · enum

Default solana, or ethereum for 0x addresses

Enum values:

solana

ethereum

base

bsc

priceUsd

number · min: 0

Threshold in USD, for price_above / price_below

minTraders

integer · min: 2 · max: 20

smart_money_buy: how many tracked traders must buy. Default 2

channel

string · enum

email (the account's address, default) or webhook

Enum values:

webhook

webhookUrl

string · uri

https Discord, Slack or Telegram bot webhook URL, when channel is webhook

note

string · maxLength: 200

A short reminder of why the user set it

Create a price or smart-money alert - 0 credits › Responses

{ data, notes?, credits, meta }

No data returned

POST/api/v1/tools/stalkchain_alert_create

curl https://data.stalkchain.com/api/v1/tools/stalkchain_alert_create \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "kind": "price_above",
  "token": "tokenaaaaaaaaaaaaaaa",
  "chain": "solana",
  "priceUsd": 0,
  "minTraders": 2,
  "channel": "email",
  "webhookUrl": "https://www.example.com/path/to/resource",
  "note": "note"
}'

Example Request Body

{
  "kind": "price_above",
  "token": "tokenaaaaaaaaaaaaaaa",
  "chain": "solana",
  "priceUsd": 0,
  "minTraders": 2,
  "channel": "email",
  "webhookUrl": "https://www.example.com/path/to/resource",
  "note": "note"
}

json

Example Responses

No example specified for this content type

List your alerts - 0 credits

GET

https://data.stalkchain.com

/api/v1/tools/stalkchain_alert_list

List your alerts - 0 credits › Responses

200

{ data, notes?, credits, meta }

No data returned

List your alerts - 0 credits

POST

https://data.stalkchain.com

/api/v1/tools/stalkchain_alert_list

The user's alerts: what each watches, how it notifies, whether it is still active or has fired (and when, and why). Use before deleting, or when the user asks what alerts they have.

List your alerts - 0 credits › Request Body optional

List your alerts - 0 credits › Responses

{ data, notes?, credits, meta }

No data returned

Delete an alert - 0 credits

GET

https://data.stalkchain.com

/api/v1/tools/stalkchain_alert_delete

Delete an alert - 0 credits › query Parameters

id

string · uuid · required

Delete an alert - 0 credits › Responses

200

{ data, notes?, credits, meta }

No data returned

Delete an alert - 0 credits

POST

https://data.stalkchain.com

/api/v1/tools/stalkchain_alert_delete

Switch off and delete one of the user's alerts by id (from stalkchain_alert_list). Confirm which alert with the user first.

Delete an alert - 0 credits › Request Body optional

id

string · uuid · required

Delete an alert - 0 credits › Responses

{ data, notes?, credits, meta }

No data returned

StonkFun launchpad Account & status