tickerbot_create_universe
Creates a named ticker universe to scope screens and subscriptions, letting you save a reusable list of symbols for consistent filtering.
Instructions
Saves a named list of tickers to scope screens and subscriptions.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"tickers": "<tickers>",
"name": "<name>"
},
"name": "tickerbot_create_universe"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Optional slug: the universe's permanent handle everywhere (`?universe=`, subscribe `universe`, CRUD path). Pattern `^[a-z][a-z0-9_]{0,62}$`: starts with a lowercase letter, then lowercase letters/digits/underscore, 63 chars max; the value is trimmed and lowercased before validation. `top_10` and `top_100` are reserved for built-in universes and rejected with 400. Must be unique within your account. Generated (`u_…`) if omitted. | |
| name | Yes | Display name, up to 80 characters. Display only: the `id` is what references the universe. | |
| tickers | Yes | Ticker symbols, up to 10,000. Validated against the tickers we track. `[]` is accepted: an empty universe you can fill later via PATCH. | |
| description | No | Free-form notes, up to 500 characters. Stored as `""` when omitted. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The slug: the universe's handle in `?universe=`. | |
| kind | Yes | Always `custom` here: a universe you create or edit is yours. One of: `builtin`, `custom`. | |
| name | Yes | Display label. | |
| size | Yes | Member count. | |
| as_of | Yes | Server time this response was assembled (ISO 8601); on an as-of read, the instant you asked for (As-of). | |
| tickers | Yes | Members, after this call. | |
| created_at | Yes | Creation timestamp (epoch seconds). | |
| updated_at | Yes | Last modification timestamp (epoch seconds). | |
| _advisories | No | Present only when the response carried a warning: `deprecated` (since, sunset_on, successor, warning; on a deprecated tool, successor names the tool to call), `rate_limit` (warning, retry_after_seconds, limit, remaining, reset_epoch_s) or `monthly_quota` (warning, limit, remaining, reset_epoch_s). | |
| description | Yes | Free-form notes; `""` when unset. | |
| effective_at | No | Built-in universes only, in epoch seconds; absent on yours. | |
| rebalance_method | No | Built-in universes only; absent on yours. | |
| next_rebalance_at | No | Built-in universes only, in epoch seconds; absent on yours. |