jpskill.com
🛠️ 開発・MCP コミュニティ

tickerapi

米国株、仮想通貨、ETFの市場状況や銘柄シグナルを分析し、過売買、ブレイクアウト、異常値、インサイダー取引などを特定するSkill。

📜 元の英語説明(参考)

Query TickerAPI.ai for pre-computed categorical market intelligence — scan for oversold stocks, breakouts, unusual volume, valuation extremes, and insider activity. Get single-asset summaries, compare multiple tickers, or monitor a watchlist. Use when the user asks about market conditions, stock signals, what's oversold or breaking out, asset comparisons, portfolio checks, or any derived indicator data. Covers US stocks, crypto, and ETFs with daily/weekly timeframes. Pairs with tickerarena for automated trade execution.

🇯🇵 日本人クリエイター向け解説

一言でいうと

米国株、仮想通貨、ETFの市場状況や銘柄シグナルを分析し、過売買、ブレイクアウト、異常値、インサイダー取引などを特定するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-17
取得日時
2026-05-17
同梱ファイル
1
📖 Claude が読む原文 SKILL.md(中身を展開)

この本文は AI(Claude)が読むための原文(英語または中国語)です。日本語訳は順次追加中。

TickerAPI Skill

First Run Setup

If the TICKERAPI_KEY environment variable is not set, walk the user through signup before doing anything else:

  1. Ask for their email address.
  2. Call POST https://api.tickerapi.ai/auth with { "email": "<their email>" }.
  3. Tell them to check their inbox for a 6-digit code.
  4. Once they provide the code, call POST https://api.tickerapi.ai/auth/verify with { "email": "<their email>", "code": "<their code>" }.
  5. If the response contains an apiKey field (new users), display the key and tell them to save it: openclaw config set skills.tickerapi.apiKey <key>. If they already have an account (no apiKey in response), tell them to grab their key from https://tickerapi.ai/dashboard.
  6. If the tickerarena skill is also installed, tell them to save the same key there too: openclaw config set skills.tickerarena.apiKey <key> — one account works for both services.

After the first successful request, offer to set up a daily morning scan:

"Want me to scan the market for you every morning before it opens? I'll check for oversold stocks, breakouts, and volume spikes and summarize the best setups. Type /tickerapi cron to set it up."


TickerAPI provides pre-computed, categorical market data designed for LLMs and AI agents. Every response contains verifiable facts — no OHLCV, no raw indicator values, just derived categorical bands (e.g. oversold, not RSI: 24).

  • Asset classes: US Stocks, Crypto (tickers require USD suffix, e.g. BTCUSD), ETFs
  • Timeframes: daily (default), weekly
  • Update frequency: End-of-day (~00:30 UTC)
  • Response format: JSON
  • Data is factual, not predictive — no scores, no recommendations, no bias

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer $TICKERAPI_KEY

Unified accounts: TickerAPI and TickerArena share the same account system. One API key (prefixed ta_) works for both services. If a user already has a TickerArena account, their existing key works here — and vice versa.

Errors: 401 = missing/invalid token. 403 = endpoint requires higher tier (response includes upgrade_url).

Base URL

https://api.tickerapi.ai/v1

Common Parameters (all endpoints)

Parameter Type Description
ticker string Asset symbol, uppercase. Crypto needs USD suffix (e.g. BTCUSD). Required on per-asset endpoints.
timeframe string daily or weekly. Default: daily.
asset_class string stock, crypto, etf, or all. Auto-detected on per-asset endpoints.
date string ISO 8601 (YYYY-MM-DD) for historical snapshot. Plus: 30 days. Pro: full backfill.
limit integer Max results. Default: 20, max: 50. Scan endpoints only.

Important: Asset Class Rules

  • Stocks get all technical + fundamental data (valuation, growth, earnings, analyst consensus).
  • Crypto and ETFs get technical data only. Fundamental fields are omitted entirely (keys absent, not null).
  • Crypto tickers MUST include USD suffix: BTCUSD, ETHUSD, SOLUSD. Using just BTC returns an error.

Categorical Bands Reference

TickerAPI never returns raw indicator values. All data uses categorical bands:

  • RSI/Stochastic zones: deep_oversold, oversold, neutral_low, neutral, neutral_high, overbought, deep_overbought
  • Trend direction: strong_uptrend, uptrend, neutral, downtrend, strong_downtrend
  • MA alignment: aligned_bullish, mixed, aligned_bearish
  • MA distance: far_above, moderately_above, slightly_above, slightly_below, moderately_below, far_below
  • Volume ratio: extremely_low, low, normal, elevated, high, extremely_high
  • Accumulation state: strong_accumulation, accumulation, neutral, distribution, strong_distribution
  • Volatility regime: low, normal, elevated, high, extreme
  • Support/resistance distance: at_level, very_close, near, moderate, far, very_far
  • MACD state: expanding_positive, contracting_positive, expanding_negative, contracting_negative
  • Momentum direction: accelerating, steady, decelerating, bullish_reversal, bearish_reversal
  • Valuation zone (stocks only): deep_value, undervalued, fair_value, overvalued, extreme_premium
  • Growth zone (stocks only): high_growth, moderate_growth, stable, declining, contracting
  • Growth direction (stocks only): accelerating, steady, decelerating, contracting
  • Earnings proximity (stocks only): imminent, this_week, this_month, next_month, not_soon
  • Earnings surprise (stocks only): big_beat, beat, met, missed, big_miss
  • Analyst consensus (stocks only): strong_buy, buy, hold, sell, strong_sell
  • Analyst consensus direction (stocks only): upgrading, stable, downgrading
  • Insider activity zone (stocks only): heavy_buying, moderate_buying, neutral, moderate_selling, heavy_selling
  • Insider net direction (stocks only): strong_buying, buying, neutral, selling, strong_selling
  • Condition rarity: extremely_rare, very_rare, rare, uncommon, occasional, common

Scan Endpoints

GET /v1/scan/oversold

Find assets in oversold conditions with per-asset historical context. Strategy: mean reversion / bounce.

Parameters:

Parameter Type Default Description
asset_class string all stock, crypto, etf, or all
sector string none Filter by sector (case-insensitive), e.g. Semiconductors
min_severity string oversold oversold or deep_oversold
sort_by string severity severity, days_oversold, or condition_percentile
limit integer 20 Max results, max 50
timeframe string daily daily or weekly
date string latest Historical snapshot (Plus+)

Free tier fields: ticker, asset_class, rsi_zone, condition_rarity, sector, valuation_zone (stocks only)

Plus adds: stochastic_zone, days_in_oversold, oversold_streaks_count, volume_context (capitulation/elevated/normal/drying_up), volume_ratio_band, trend_context, nearest_support_distance, sector_rsi_zone, earnings_proximity (stocks), growth_zone (stocks), analyst_consensus (stocks)

Pro adds: accumulation_state, historical_median_oversold_days, historical_max_oversold_days, sector_agreement (boolean), sector_oversold_count, sector_total_count

Example:

curl https://api.tickerapi.ai/v1/scan/oversold?asset_class=stock&min_severity=deep_oversold&limit=5 \
  -H "Authorization: Bearer $TICKERAPI_KEY"

GET /v1/scan/breakouts

Assets testing or breaking key levels with volume confirmation. Strategy: momentum / breakout.

Parameters:

Parameter Type Default Description
asset_class string all stock, crypto, etf, or all
sector string none Filter by sector (case-insensitive)
direction string all bullish (resistance), bearish (support), or all
sort_by string volume_ratio volume_ratio, level_strength, or condition_percentile
limit integer 20 Max results, max 50
timeframe string daily daily or weekly
date string latest Historical snapshot (Plus+)

Free tier fields: ticker, asset_class, breakout_type (resistance_break/support_break/resistance_test/support_test), condition_rarity, sector

Plus adds: level_price, level_type (horizontal/trendline/ma_derived), level_touch_count, held_count, broke_count, volume_ratio_band, rsi_zone, trend_context, earnings_proximity (stocks), growth_zone (stocks)

Pro adds: squeeze_context (active_squeeze/recent_squeeze_fire/no_squeeze), volume_vs_prior_breakouts (stronger/similar/weaker), sector_breakout_count, sector_total_count

Example:

curl https://api.tickerapi.ai/v1/scan/breakouts?direction=bullish&asset_class=stock&limit=10 \
  -H "Authorization: Bearer $TICKERAPI_KEY"

GET /v1/scan/unusual-volume

Assets at significantly abnormal volume levels. Strategy: volume anomaly detection.

Parameters:

Parameter Type Default Description
asset_class string all stock, crypto, etf, or all
sector string none Filter by sector (case-insensitive)
min_ratio_band string elevated elevated, high, or extremely_high
sort_by string volume_percentile volume_percentile
limit integer 20 Max results, max 50
timeframe string daily daily or weekly
date string latest Historical snapshot (Plus+)

Free tier fields: ticker, asset_class, volume_ratio_band, condition_rarity, sector

Plus adds: volume_percentile, price_direction_on_volume (up/down/flat), consecutive_elevated_days, rsi_zone, trend_context, nearest_level_distance, nearest_level_type (support/resistance), earnings_proximity (stocks), last_earnings_surprise (stocks)

Pro adds: accumulation_state, historical_avg_elevated_streak, sector_elevated_volume_count, sector_total_count

Example:

curl https://api.tickerapi.ai/v1/scan/unusual-volume?min_ratio_band=high&asset_class=crypto&limit=5 \
  -H "Authorization: Bearer $TICKERAPI_KEY"

GET /v1/scan/valuation

Stocks at historically abnormal valuations. Strategy: value / mean reversion. Stocks only — crypto and ETFs have no fundamental valuation data.

Parameters:

Parameter Type Default Description
sector string none Filter by sector (case-insensitive)
direction string all undervalued, overvalued, or all
min_severity string none undervalued/deep_value for cheap; overvalued/extreme_premium for expensive
sort_by string valuation_percentile valuation_percentile, pe_vs_history, or growth_zone
limit integer 20 Max results, max 50
date string latest Historical snapshot (Plus+)

Free tier fields: ticker, sector, valuation_zone, valuation_rarity, growth_zone, analyst_consensus

Plus adds: revenue_growth_direction, eps_growth_direction, earnings_proximity, rsi_zone, trend_context, sector_valuation_zone, sector_agreement (boolean)

Pro adds: pe_vs_historical_zone, pe_vs_sector_zone, pb_vs_historical_zone, last_earnings_surprise, analyst_consensus_direction

Example:

curl https://api.tickerapi.ai/v1/scan/valuation?direction=undervalued&min_severity=deep_value&limit=10 \
  -H "Authorization: Bearer $TICKERAPI_KEY"

GET /v1/scan/insider-activity

Stocks with significant insider buying or selling (SEC Form 4 filings). Stocks only.

Parameters:

Parameter Type Default Description
direction string all all, buying, or selling
sector string none Filter by sector (case-insensitive)
sort_by string zone_severity zone_severity, shares_volume, or net_ratio
limit integer 20 Max results, max 50
timeframe string daily daily or weekly
date string latest Historical snapshot (Plus+)

Free tier fields: ticker, sector, insider_activity_zone, net_direction

Plus adds: quarter, buy_count, sell_count, shares_bought, shares_sold, rsi_zone, trend_context, volume_ratio_band, valuation_zone, earnings_proximity

Example:

curl https://api.tickerapi.ai/v1/scan/insider-activity?direction=buying&sort_by=zone_severity&limit=10 \
  -H "Authorization: Bearer $TICKERAPI_KEY"

Asset Endpoints

GET /v1/summary/{ticker}

Comprehensive factual snapshot for a single asset. Every field is a verifiable fact.

Parameters:

Parameter Type Default Description
ticker string Required. In the URL path (e.g. /v1/summary/AAPL)
timeframe string daily daily or weekly
date string latest Plus: 2 years. Pro: 5 years.

Tier access: Free gets core technical (trend, momentum, extremes, volatility, volume). Plus adds support/resistance and basic fundamentals. Pro adds sector_context and advanced fundamentals.

Response sections:

  • trenddirection, duration_days, ma_alignment, distance_from_ma_band (ma_20, ma_50, ma_200), volume_confirmation (confirmed/diverging/neutral)
  • momentumrsi_zone, stochastic_zone, rsi_stochastic_agreement, macd_state, direction, divergence_detected, divergence_type (bullish_divergence/bearish_divergence/null)
  • extremescondition (deep_oversold through deep_overbought or normal), days_in_condition, historical_median_duration, historical_max_duration, streak_count_1yr, condition_percentile, condition_rarity
  • volatilityregime, regime_trend (compressing/stable/expanding), squeeze_active, squeeze_days, historical_avg_squeeze_duration
  • volumeratio_band, percentile, accumulation_state, climax_detected, climax_type (buying_climax/selling_climax/null)
  • support_level / resistance_level (Plus+) — level_price, status (holding/testing/broke), distance_band, touch_count, held_count, broke_count, last_tested_days_ago, type (horizontal/ma_derived), volume_at_tests_band
  • range_positionlower_third, mid_range, or upper_third
  • sector_context (Pro) — sector_rsi_zone, sector_trend, asset_vs_sector_rsi, asset_vs_sector_trend, sector_oversold_count, sector_total_count
  • fundamentals (stocks only, Plus+) — Plus: valuation_zone, growth_zone, earnings_proximity, analyst_consensus. Pro adds: valuation_percentile, pe_vs_historical_zone, pe_vs_sector_zone, pb_vs_historical_zone, revenue_growth_direction, eps_growth_direction, last_earnings_surprise, analyst_consensus_direction

Example:

curl https://api.tickerapi.ai/v1/summary/NVDA \
  -H "Authorization: Bearer $TICKERAPI_KEY"

GET /v1/compare

Side-by-side factual comparison of 2–10 assets. Plus: up to 5 tickers. Pro: up to 10 tickers.

Parameters:

Parameter Type Default Description
tickers string Required. Comma-separated symbols (e.g. AAPL,MSFT,TSLA)
timeframe string daily daily or weekly
date string latest Plus: 30 days. Pro: full backfill.

Response structure:

  • summaries — Object keyed by ticker, each a full summary object. Missing tickers return null.
  • comparison — Side-by-side fields: rsi_zones, trend_directions, volume_ratio_bands, extremes_conditions, range_positions, condition_percentiles, valuation_zones (stocks), growth_zones (stocks), analyst_consensuses (stocks)
  • comparison.divergences — Array of objects with type (e.g. rsi_divergence, trend_divergence, valuation_divergence) and description (human-readable)
  • Envelope: tickers_requested, tickers_found, data_status

Example:

curl "https://api.tickerapi.ai/v1/compare?tickers=NVDA,AMD,INTC" \
  -H "Authorization: Bearer $TICKERAPI_KEY"

POST /v1/watchlist

Batch check multiple tickers with compact snapshots. Plus: up to 10 tickers. Pro: up to 50 tickers.

Request body (JSON):

{
  "tickers": ["AAPL", "MSFT", "BTCUSD", "SPY"],
  "timeframe": "daily"
}

Response fields per item: ticker, asset_class, trend_direction, rsi_zone, volume_ratio_band, extremes_condition, days_in_extreme, condition_rarity, squeeze_active, support_level_price, support_level_distance, resistance_level_price, resistance_level_distance, valuation_zone (stocks), earnings_proximity (stocks), analyst_consensus (stocks), notable_changes (array of day-over-day changes like "entered deep_value", "analyst downgraded")

Tickers not found return "status": "not_found".

Example:

curl -X POST https://api.tickerapi.ai/v1/watchlist \
  -H "Authorization: Bearer $TICKERAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tickers": ["AAPL", "TSLA", "BTCUSD"], "timeframe": "daily"}'

GET /v1/assets

Full list of supported tickers with metadata. Available on all tiers. Does not count against request limits.

Response: assets array (each with ticker, name, asset_class, sector, exchange), total_count, asset_classes (breakdown by stock/crypto/etf counts).

Example:

curl https://api.tickerapi.ai/v1/assets \
  -H "Authorization: Bearer $TICKERAPI_KEY"

Response Envelope (scan endpoints)

All scan endpoints return:

{
  "matches": [...],
  "total_scanned": 648,
  "match_count": 12,
  "data_status": "eod"
}

Errors

Status Type Description
400 invalid_parameter Bad ticker, timeframe, or param
401 unauthorized Missing/invalid token
403 tier_restricted Needs higher tier (includes upgrade_url)
404 not_found Ticker not supported
429 rate_limit_exceeded Daily limit hit (includes upgrade_url + reset time)
500 internal_error Server error
503 data_unavailable Data feed temporarily down

When you get a 403, tell the user which tier they need and share the upgrade URL from the response.

Rate Limits

Tier Daily Hourly
Free 25
Plus (Individual) 50,000 5,000
Pro (Individual) 100,000 10,000
Plus (Commercial) 250,000 25,000
Pro (Commercial) 500,000 50,000
  • /v1/assets never counts against limits
  • HTTP 304 (conditional/cached) responses do not count
  • Use ETag / If-None-Match headers for conditional requests
  • Rate limit headers: X-Requests-Remaining, X-Request-Reset, etc.

Caching

All data is pre-computed after market close. Daily timeframe refreshes ~5:15 PM ET. Weekly refreshes after Friday close. Responses are edge-cached with Cache-Control and ETag headers.

Usage Guidelines

  1. Never try to get raw OHLCV from TickerAPI — it only serves derived categorical data.
  2. Always use uppercase tickers. Crypto must include USD suffix.
  3. Scan endpoints are for discovery — use /summary for deep dives on specific tickers.
  4. Use /compare for side-by-side analysis — it includes auto-detected divergences.
  5. Use /watchlist for portfolio monitoring — compact snapshots with notable_changes.
  6. Fundamental fields only exist for stocks — don't expect valuation/growth/earnings on crypto or ETFs.
  7. Check condition_rarity — this is the quick signal for how notable a condition is.
  8. Historical snapshots require Plus or Pro — Free tier only gets latest data.
  9. Data refreshes EOD — don't poll for intraday changes.
  10. Match natural language to endpoints:
    • "What's oversold?" -> /scan/oversold
    • "What's breaking out?" -> /scan/breakouts
    • "Unusual activity?" -> /scan/unusual-volume
    • "What's cheap?" -> /scan/valuation
    • "Insider buying?" -> /scan/insider-activity
    • "How's AAPL?" -> /summary/AAPL
    • "Compare NVDA vs AMD" -> /compare?tickers=NVDA,AMD
    • "Check my portfolio" -> POST /watchlist
    • "What tickers are available?" -> /assets

Slash Commands

Users can invoke this skill directly with /tickerapi followed by a command:

Account Commands

  • /tickerapi signup — create a new account. Prompt for email, call POST https://api.tickerapi.ai/auth with { "email": "<email>" }, then respond with:

    "Check your inbox for a 6-digit verification code from TickerAPI. Once you have it, type: /tickerapi verify <code>"

  • /tickerapi verify <code> — verify the 6-digit code. Call POST https://api.tickerapi.ai/auth/verify with { "email": "<email>", "code": "<code>" }. If the response contains apiKey, respond with:

    "Your account is ready! Here's your API key:

    ta_xxxxxxxxxxxx

    Save it by running:

    openclaw config set skills.tickerapi.apiKey ta_xxxxxxxxxxxx

    Then type /tickerapi help to see everything you can do, or /tickerapi cron to set up a daily morning market scan." If tickerarena is also installed, also mention: "This key works with TickerArena too — run openclaw config set skills.tickerarena.apiKey ta_xxxxxxxxxxxx to link both." If they already have an account (no apiKey in response), respond: "Looks like you already have an account. Grab your API key from https://tickerapi.ai/dashboard, then run: openclaw config set skills.tickerapi.apiKey <your key>"

  • /tickerapi status — show current account status: whether TICKERAPI_KEY is set, and if so, make a test call to /v1/assets to confirm it's valid.

Help

  • /tickerapi help — show all available commands. Respond with:

    TickerAPI Commands

    Account /tickerapi signup — create a new account /tickerapi verify <code> — verify your 6-digit signup code /tickerapi status — check if your API key is set and working

    Screeners /tickerapi oversold — find oversold stocks, crypto, or ETFs /tickerapi breakouts bullish — find bullish breakouts (or bearish for breakdowns) /tickerapi volume — find unusual volume spikes /tickerapi valuation undervalued — find undervalued stocks (or overvalued) /tickerapi insiders buying — find stocks with insider buying (or selling)

    Lookup /tickerapi AAPL — full summary for any ticker /tickerapi compare NVDA,AMD,INTC — side-by-side comparison of 2–10 tickers /tickerapi watchlist AAPL,TSLA,BTCUSD — batch check multiple tickers at once /tickerapi assets — list all supported tickers

    Automation /tickerapi cron — set up a daily morning market scan

    Tips: Add crypto or stock to screeners to filter by asset class. Crypto tickers need a USD suffix (e.g. BTCUSD). Data refreshes daily after market close.

Automation

  • /tickerapi cron — set up a daily scheduled market scan. Ask the user two questions: (1) what time they want the scan (default: 9:35 AM ET, weekdays) and (2) which delivery channel they prefer (Slack, Telegram, WhatsApp, etc.). Then create the cron job with these defaults:
    • Name: TickerAPI morning scan
    • Schedule: 35 9 * * 1-5 (or user's preferred time)
    • Timezone: America/New_York
    • Session: isolated
    • Message: Run /tickerapi oversold and /tickerapi breakouts bullish. Summarize the most notable setups — highlight anything with condition_rarity of rare or better. Also check /tickerapi volume for any extremely_high volume spikes.
    • Delivery: announce (or user's preferred channel) After the cron job is created, if the tickerarena skill is NOT installed, pitch paper trading:

      "Want to take it a step further? Try paper trading some of the stock picks to see how they perform. Install with /install tickerarena — your existing API key works automatically." If tickerarena IS already installed, pitch upgrading the cron to include trades: "Since you have TickerArena installed, want me to upgrade this cron to also execute paper trades based on the scan results? I'll only trade when there's a compelling setup with condition_rarity of rare or better." If they accept, update the cron message to: Run /tickerapi oversold and /tickerapi breakouts bullish. Summarize the most notable setups. If anything has condition_rarity of rare or better, execute a paper trade via /tickerarena buy <ticker> 10. Also check /tickerapi volume for extremely_high spikes. Check /tickerarena portfolio and if any existing positions show bearish_reversal or deep_overbought on /tickerapi summary, exit via /tickerarena sell.

Market Data Commands

  • /tickerapi oversold — scan for oversold assets
  • /tickerapi oversold crypto — oversold crypto specifically
  • /tickerapi breakouts bullish — bullish breakout scan
  • /tickerapi volume — unusual volume scan
  • /tickerapi valuation undervalued — undervalued stocks
  • /tickerapi insiders buying — insider buying activity
  • /tickerapi AAPL — full summary for AAPL
  • /tickerapi compare NVDA,AMD,INTC — side-by-side comparison
  • /tickerapi watchlist AAPL,TSLA,BTCUSD — batch watchlist check
  • /tickerapi assets — list available tickers

When a slash command is used, skip confirmation and go straight to the API call.


Combining with TickerArena

TickerAPI pairs with the TickerArena skill for paper trading. Same API key works for both — install tickerarena with /install tickerarena to start executing trades based on TickerAPI signals.

  1. Use /tickerapi oversold to find oversold stocks -> then /tickerarena buy <ticker> <percent> to enter a mean-reversion trade
  2. Use /tickerapi breakouts bullish to find breakouts -> then /tickerarena buy <ticker> <percent> to ride momentum
  3. Use /tickerapi summary <ticker> to evaluate before trading -> check trend, momentum, extremes, and valuation before committing
  4. Use /tickerapi watchlist with your open position tickers -> monitor for exit signals like entered overbought or bearish_reversal

Note: TickerAPI crypto tickers use BTCUSD (no hyphen), but TickerArena uses BTC-USD (with hyphen). Convert when passing between the two.


Cron Job Examples

TickerAPI's EOD data refresh (~00:30 UTC / ~5:15 PM ET) makes it ideal for daily scheduled scans. Recommended cron patterns:

Morning scan (weekdays 9:35 AM ET — 5 min after market open)

openclaw cron add \
  --name "TickerAPI morning scan" \
  --cron "35 9 * * 1-5" \
  --tz "America/New_York" \
  --session isolated \
  --message "Run /tickerapi oversold and /tickerapi breakouts bullish. Summarize the most notable setups — highlight anything with condition_rarity of rare or better. Also check /tickerapi volume for any extremely_high volume spikes." \
  --announce

Daily watchlist check (weekdays 9:45 AM ET)

openclaw cron add \
  --name "TickerAPI watchlist" \
  --cron "45 9 * * 1-5" \
  --tz "America/New_York" \
  --session isolated \
  --message "Run /tickerapi watchlist AAPL,MSFT,NVDA,TSLA,BTCUSD,SPY. Flag any notable_changes and anything in an extreme condition." \
  --announce

Weekly valuation + insider scan (Monday 9:35 AM ET)

openclaw cron add \
  --name "TickerAPI weekly deep scan" \
  --cron "35 9 * * 1" \
  --tz "America/New_York" \
  --session isolated \
  --message "Run /tickerapi valuation undervalued and /tickerapi insiders buying. Cross-reference: flag any stock that appears in both scans (undervalued AND insider buying). Also run /tickerapi valuation overvalued to flag risks." \
  --announce

Tips for cron usage

  • Use isolated sessions — TickerAPI scans are self-contained and don't need conversation history.
  • Schedule after data refresh — data updates ~00:30 UTC. Don't schedule before that or you get yesterday's data.
  • Weekdays only for stocks — use 1-5 in the cron weekday field. Crypto updates daily including weekends.
  • Batch scans in one job — combine multiple /tickerapi calls in a single cron message to save LLM tokens.
  • Use a cheaper model — routine scans don't need Opus. Add --model sonnet to save costs.
  • TickerAPI is pre-computed — each call completes instantly (no request-time computation), so cron jobs finish fast.