create_monitor
Persist a stock, wallet, receipt or exact-pool price/liquidity/24h-volume watch. Events go to the account inbox and separately opted-in channel deliveries. No trading.
Create a monitor
Persist a stock, wallet, receipt or exact-pool price/liquidity/24h-volume watch. Events go to the account inbox and separately opted-in channel deliveries. No trading.
Permission and calling convention
Required scope: monitors:write. This tool can change account-owned settings or prepare a request. Use only for an intentional user action.
This tool does not sign or broadcast a transaction. Check errors, source timestamps and explicit unavailable fields before using the result.
POST /api/tools/create_monitor
Authorization: Bearer <ULTRON_ACCESS_KEY>
Content-Type: application/jsonInput schema
Inputs are validated against this current schema. Use exact values from live source results rather than substituting a ticker for a contract or a different chain.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 70
},
"kind": {
"type": "string",
"enum": [
"stock_price",
"multiplier",
"native_balance",
"transaction",
"market_price",
"market_liquidity",
"market_volume",
"market_signal"
]
},
"target": {
"type": "string",
"minLength": 1,
"maxLength": 70
},
"operator": {
"default": "changed",
"type": "string",
"enum": [
"above",
"below",
"changed"
]
},
"threshold": {
"type": "number"
},
"signal": {
"type": "object",
"properties": {
"priceMovementDirection": {
"default": "up",
"type": "string",
"enum": [
"up",
"down",
"either"
]
},
"minVolume1hUsd": {
"type": "number",
"minimum": 0,
"maximum": 1000000000000
},
"minPriceChange1hPercent": {
"type": "number",
"minimum": 0,
"maximum": 100000
},
"minLiquidityUsd": {
"type": "number",
"minimum": 0,
"maximum": 1000000000000
},
"minMarketCapUsd": {
"type": "number",
"minimum": 0,
"maximum": 1000000000000000
},
"maxMarketCapUsd": {
"type": "number",
"minimum": 1,
"maximum": 1000000000000000
}
},
"required": [
"priceMovementDirection",
"minVolume1hUsd",
"minPriceChange1hPercent",
"minLiquidityUsd"
],
"additionalProperties": false
},
"intervalSeconds": {
"default": 300,
"type": "integer",
"minimum": 60,
"maximum": 86400
}
},
"required": [
"name",
"kind",
"target",
"operator",
"intervalSeconds"
],
"additionalProperties": false
}