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

TickerAPI.aiを活用し、割安な株や出来高急増銘柄、インサイダー取引など、市場の状況や個別銘柄の分析指標に関する情報を手軽に取得し、ポートフォリオのチェックなどに役立てるSkill。

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本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o tickerapi.zip https://jpskill.com/download/5485.zip && unzip -o tickerapi.zip && rm tickerapi.zip
🪟 Windows (PowerShell)
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/5485.zip -OutFile "$d\tickerapi.zip"; Expand-Archive "$d\tickerapi.zip" -DestinationPath $d -Force; ri "$d\tickerapi.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して tickerapi.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → tickerapi フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動

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

🎯 この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-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

TickerAPI スキル

初回実行時の設定

TICKERAPI_KEY 環境変数が設定されていない場合、他の処理を行う前にユーザーにサインアップを促します。

  1. メールアドレスを尋ねます。
  2. { "email": "<ユーザーのメールアドレス>" } を指定して POST https://api.tickerapi.ai/auth を呼び出します。
  3. 6桁のコードが記載されたメールが届いていることを伝えます。
  4. ユーザーがコードを提供したら、{ "email": "<ユーザーのメールアドレス>", "code": "<ユーザーのコード>" } を指定して POST https://api.tickerapi.ai/auth/verify を呼び出します。
  5. レスポンスに apiKey フィールドが含まれている場合(新規ユーザー)、キーを表示し、openclaw config set skills.tickerapi.apiKey <キー> を使用して保存するように伝えます。すでにアカウントを持っている場合(レスポンスに apiKey がない場合)、https://tickerapi.ai/dashboard からキーを取得するように伝えます。
  6. tickerarena スキルもインストールされている場合、同じキーをそちらにも保存するように伝えます: openclaw config set skills.tickerarena.apiKey <キー> — 1つのアカウントで両方のサービスが機能します。

最初の成功したリクエストの後、毎朝の市場スキャンを設定することを提案します。

「市場が開く前に、毎朝市場をスキャンしましょうか?売られすぎの株、ブレイクアウト、出来高の急増をチェックし、最適な設定を要約します。設定するには /tickerapi cron と入力してください。」


TickerAPI は、LLM および AI エージェント向けに設計された、事前に計算されたカテゴリ別市場データを提供します。すべてのレスポンスには検証可能な事実が含まれています — OHLCV、生のインジケーター値はなく、導出されたカテゴリバンドのみです(例: RSI: 24 ではなく oversold)。

  • 資産クラス: 米国株、暗号通貨(ティッカーには USD サフィックスが必要、例: BTCUSD)、ETF
  • 時間枠: daily(デフォルト)、weekly
  • 更新頻度: 終値後(UTC 00:30頃)
  • レスポンス形式: JSON
  • データは事実であり、予測ではありません — スコア、推奨、偏見はありません

認証

すべてのリクエストには、Authorization ヘッダーに Bearer トークンが必要です。

Authorization: Bearer $TICKERAPI_KEY

統合アカウント: TickerAPI と TickerArena は同じアカウントシステムを共有しています。1つの API キー(ta_ プレフィックス付き)で両方のサービスが機能します。ユーザーがすでに TickerArena アカウントを持っている場合、既存のキーがここで機能します — その逆も同様です。

エラー: 401 = トークンが見つからない/無効です。403 = エンドポイントにはより高いティアが必要です(レスポンスに upgrade_url が含まれます)。

ベース URL

https://api.tickerapi.ai/v1

共通パラメーター(すべてのエンドポイント)

パラメーター 説明
ticker string 資産シンボル、大文字。暗号通貨には USD サフィックスが必要(例: BTCUSD)。資産ごとのエンドポイントで必須です。
timeframe string daily または weekly。デフォルト: daily
asset_class string stockcryptoetf、または all。資産ごとのエンドポイントで自動検出されます。
date string 過去のスナップショットの ISO 8601 形式(YYYY-MM-DD)。Plus: 30日間。Pro: 完全なバックフィル。
limit integer 最大結果数。デフォルト: 20、最大: 50。スキャンエンドポイントのみ。

重要: 資産クラスのルール

  • は、すべてのテクニカルデータとファンダメンタルデータ(評価、成長、収益、アナリストコンセンサス)を取得します。
  • 暗号通貨とETFは、テクニカルデータのみを取得します。ファンダメンタルフィールドは完全に省略されます(キーが存在せず、nullではありません)。
  • 暗号通貨のティッカーには USD サフィックスを含める必要があります: BTCUSDETHUSDSOLUSD。単に BTC を使用するとエラーが返されます。

カテゴリバンドリファレンス

TickerAPI は生のインジケーター値を返すことはありません。すべてのデータはカテゴリバンドを使用します。

  • RSI/ストキャスティクスゾーン: deep_oversoldoversoldneutral_lowneutralneutral_highoverboughtdeep_overbought
  • トレンド方向: strong_uptrenduptrendneutraldowntrendstrong_downtrend
  • MAアライメント: aligned_bullishmixedaligned_bearish
  • MA距離: far_abovemoderately_aboveslightly_aboveslightly_belowmoderately_belowfar_below
  • 出来高比率: extremely_lowlownormalelevatedhighextremely_high
  • 蓄積状態: strong_accumulationaccumulationneutraldistributionstrong_distribution
  • ボラティリティ体制: lownormalelevatedhighextreme
  • サポート/レジスタンス距離: at_levelvery_closenearmoderatefarvery_far
  • MACD状態: expanding_positivecontracting_positiveexpanding_negativecontracting_negative
  • モメンタム方向: acceleratingsteadydeceleratingbullish_reversalbearish_reversal
  • 評価ゾーン(株のみ): deep_valueundervaluedfair_valueovervaluedextreme_premium
  • 成長ゾーン(株のみ): high_growthmoderate_growthstabledecliningcontracting
  • 成長方向(株のみ): acceleratingsteadydeceleratingcontracting
  • 収益の近接性(株のみ): imminentthis_weekthis_monthnext_monthnot_soon
  • 収益サプライズ(株のみ): big_beatbeatmetmissedbig_miss
  • アナリストコンセンサス(株のみ): strong_buybuyholdsellstrong_sell
  • アナリストコンセンサス方向(株のみ): upgradingstabledowngrading
  • インサイダー活動ゾーン(株のみ): heavy_buyingmoderate_buyingneutralmoderate_sellingheavy_selling
  • インサイダー純方向(株のみ): strong_buyingbuyingneutralsellingstrong_selling
  • 条件の希少性: extremely_rarevery_rarerareuncommonoccasionalcommon

スキャンエンドポイント

GET /v1/scan/oversold

売られすぎの状況にある資産を、資産ごとの履歴コンテキストとともに見つけます。戦略: 平均回帰 / 反発。

パラメーター:

パラメーター デフォルト 説明
asset_class string all stockcryptoetf、または all
sector string なし セクターでフィルタリング(大文字小文字を区別しない)、例: Semiconductors
min_severity string oversold oversold または deep_oversold
sort_by string severity severitydays_oversold、または condition_percentile
limit integer 20 最大結果数、最大 50
📜 原文 SKILL.md(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.