finamExecute trades, manage portfolios, access real-time market data, browse market assets, scan volatility, and answer questions about Finam Trade API
Install via ClawdBot CLI:
clawdbot install Alexander-Panov/finamPrerequisites: $FINAM_API_KEY and $FINAM_ACCOUNT_ID must be set in your environment.
If not configured by environment, follow these steps:
export FINAM_API_KEY="your_api_key_here"
export FINAM_ACCOUNT_ID="your_account_id_here"Obtain JWT token before using the API:
export FINAM_JWT_TOKEN=$(curl -sL "https://api.finam.ru/v1/sessions" \
--header "Content-Type: application/json" \
--data '{"secret": "'"$FINAM_API_KEY"'"}' | jq -r '.token')Note: Token expires after 15 minutes. Re-run this command if you receive authentication errors.
Symbol Format: All symbols must be in ticker@mic format (e.g., SBER@MISX)
Base MIC Codes:
MISX - Moscow ExchangeRUSX - RTSXNGS - NASDAQ/NGSXNMS - NASDAQ/NNSXNYS - New York Stock ExchangeView all supported exchanges with their MIC codes:
jq -r '.exchanges[] | "\(.mic) - \(.name)"' assets/exchanges.jsonList stocks available on a specific exchange:
MIC="MISX"
LIMIT=20
jq -r ".$MIC[:$LIMIT] | .[] | \"\(.symbol) - \(.name)\"" assets/equities.jsonFind a stock by name (case-insensitive) across all exchanges:
QUERY="apple"
jq -r --arg q "$QUERY" 'to_entries[] | .value[] | select(.name | ascii_downcase | contains($q)) | "\(.symbol) - \(.name)"' assets/equities.jsonPre-ranked lists of the 100 most liquid equities for each market, ordered by trading volume descending:
N=10
jq -r ".[:$N] | .[] | \"\(.ticker) - \(.name)\"" assets/top_ru_equities.jsonN=10
jq -r ".[:$N] | .[] | \"\(.ticker) - \(.name)\"" assets/top_us_equities.jsonRetrieve portfolio information including positions, balances, and P&L:
curl -sL "https://api.finam.ru/v1/accounts/$FINAM_ACCOUNT_ID" \
--header "Authorization: $FINAM_JWT_TOKEN" | jqRetrieve current bid/ask prices and last trade:
SYMBOL="SBER@MISX"
curl -sL "https://api.finam.ru/v1/instruments/$SYMBOL/quotes/latest" \
--header "Authorization: $FINAM_JWT_TOKEN" | jqView current market depth with bid/ask levels:
SYMBOL="SBER@MISX"
curl -sL "https://api.finam.ru/v1/instruments/$SYMBOL/orderbook" \
--header "Authorization: $FINAM_JWT_TOKEN" | jqList the most recent executed trades:
SYMBOL="SBER@MISX"
curl -sL "https://api.finam.ru/v1/instruments/$SYMBOL/trades/latest" \
--header "Authorization: $FINAM_JWT_TOKEN" | jqRetrieve historical price data with specified timeframe:
SYMBOL="SBER@MISX"
TIMEFRAME="TIME_FRAME_D"
START_TIME="2024-01-01T00:00:00Z"
END_TIME="2024-04-01T00:00:00Z"
curl -sL "https://api.finam.ru/v1/instruments/$SYMBOL/bars?timeframe=$TIMEFRAME&interval.startTime=$START_TIME&interval.endTime=$END_TIME" \
--header "Authorization: $FINAM_JWT_TOKEN" | jqAvailable Timeframes:
TIME_FRAME_M1, M5, M15, M30 - Minutes (1, 5, 15, 30)TIME_FRAME_H1, H2, H4, H8 - Hours (1, 2, 4, 8)TIME_FRAME_D - DailyTIME_FRAME_W - WeeklyTIME_FRAME_MN - MonthlyTIME_FRAME_QR - QuarterlyDate Format (RFC 3339):
YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS+HH:MMstartTime - Inclusive (interval start, included in results)endTime - Exclusive (interval end, NOT included in results)2024-01-15T10:30:00Z (UTC)2024-01-15T10:30:00+03:00 (Moscow time, UTC+3)Fetch and display the latest news headlines. No JWT token required.
Russian market news
curl -sL "https://www.finam.ru/analysis/conews/rsspoint/" | python3 -c "
import sys, xml.etree.ElementTree as ET
root = ET.parse(sys.stdin).getroot()
for item in reversed(root.findall('.//item')):
print(f'* {item.findtext('title','')}. {item.findtext('description','').split('...')[0]}')
"US market news
curl -sL "https://www.finam.ru/international/advanced/rsspoint/" | python3 -c "
import sys, xml.etree.ElementTree as ET
root = ET.parse(sys.stdin).getroot()
for item in reversed(root.findall('.//item')):
print(f'* {item.findtext('title','')}. {item.findtext('description','').split('...')[0]}')
"Parameters:
[:10] to any number to control how many headlines to displayIMPORTANT: Before placing or cancelling any order, you MUST explicitly confirm the details with the user and receive their approval. State the full order parameters (symbol, side, quantity, type, price) and wait for confirmation before executing.
Order Types:
ORDER_TYPE_MARKET - Market order (executes immediately, no limitPrice required)ORDER_TYPE_LIMIT - Limit order (requires limitPrice)curl -sL "https://api.finam.ru/v1/accounts/$FINAM_ACCOUNT_ID/orders" \
--header "Authorization: $FINAM_JWT_TOKEN" \
--header "Content-Type: application/json" \
--data "$(jq -n \
--arg symbol "SBER@MISX" \
--arg quantity "10" \
--arg side "SIDE_BUY" \
--arg type "ORDER_TYPE_LIMIT" \
--arg price "310.50" \
'{symbol: $symbol, quantity: {value: $quantity}, side: $side, type: $type, limitPrice: {value: $price}}')" \
| jqParameters:
symbol - Instrument (e.g., SBER@MISX)quantity.value - Number of shares/contractsside - SIDE_BUY or SIDE_SELLtype - ORDER_TYPE_MARKET or ORDER_TYPE_LIMITlimitPrice - Only for ORDER_TYPE_LIMIT (omit for market orders)Check the status of a specific order:
ORDER_ID="12345678"
curl -sL "https://api.finam.ru/v1/accounts/$FINAM_ACCOUNT_ID/orders/$ORDER_ID" \
--header "Authorization: $FINAM_JWT_TOKEN" | jqCancel a pending order:
ORDER_ID="12345678"
curl -sL --request DELETE "https://api.finam.ru/v1/accounts/$FINAM_ACCOUNT_ID/orders/$ORDER_ID" \
--header "Authorization: $FINAM_JWT_TOKEN" | jqScans the top-100 stocks for a given market and prints the most volatile ones based on annualized historical volatility (close-to-close, last 60 days).
Usage:
python3 scripts/volatility.py [ru|us] [N]Arguments:
ru / us — market to scan (default: ru)N — number of top results to display (default: 10)Examples:
# Top 10 most volatile Russian stocks
python3 scripts/volatility.py ru 10
# Top 5 most volatile US stocks
python3 scripts/volatility.py us 5See API Reference for full Finam Trade API details.
Generated Mar 1, 2026
Individual investors can automate trading strategies by setting up scripts to monitor market conditions and execute trades via the Finam API. For example, a user could create a bot that buys SBER@MISX when its price drops below a certain threshold, using historical candles to analyze trends and place limit orders. This reduces manual effort and enables 24/7 market participation, leveraging real-time quotes and order book data for precise entries.
Financial advisors can use the skill to periodically rebalance client portfolios by fetching current positions and market data. They can automate adjustments based on asset allocation targets, such as selling overperforming stocks and buying underweight ones, using account management and order placement features. This ensures compliance with investment strategies while saving time on manual calculations and trade executions.
Analysts at investment firms can generate reports by pulling real-time quotes, historical data, and news headlines to assess market trends. For instance, they might scan volatility by comparing recent trades and OHLCV data across multiple symbols, then compile insights into dashboards. This supports data-driven decision-making for clients or internal teams, with easy integration into existing tools via API calls.
Developers can build and test algorithmic trading systems by accessing market data and executing trades programmatically. They can implement strategies like arbitrage using order book depth or momentum trading based on historical candles, with the skill handling authentication and API interactions. This accelerates prototyping and deployment for hedge funds or proprietary trading desks, focusing on strategy logic rather than infrastructure.
Offer tiered subscription plans where users pay monthly or annually for enhanced API features, such as higher rate limits, premium market data feeds, or advanced analytics. Revenue is generated from individual traders, small firms, and developers who need reliable access to Finam's trading infrastructure. This model ensures recurring income while scaling with user demand for real-time data and execution capabilities.
License the skill as a white-label solution for brokers or financial institutions to integrate into their own platforms, providing clients with trading, portfolio management, and market data tools. Revenue comes from licensing fees and customization services, targeting businesses that want to offer branded trading experiences without building from scratch. This leverages the skill's comprehensive API coverage and ease of setup.
Generate revenue by charging a small commission on each trade executed through the skill, similar to traditional brokerage models. This appeals to active traders and automated systems that place frequent orders, with income scaling based on trading volume. It can be combined with free basic access to attract users, then monetize through transaction fees for market and limit orders.
💬 Integration Tip
Ensure environment variables for API keys are securely managed, and automate JWT token renewal to avoid authentication errors during long sessions.
Analyze stocks and cryptocurrencies using Yahoo Finance data. Supports portfolio management, watchlists with alerts, dividend analysis, 8-dimension stock scoring, viral trend detection (Hot Scanner), and rumor/early signal detection. Use for stock analysis, portfolio tracking, earnings reactions, crypto monitoring, trending stocks, or finding rumors before they hit mainstream.
Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Uses yfinance library - no API key required.
Yahoo Finance (yfinance) powered stock analysis skill: quotes, fundamentals, ASCII trends, high-resolution charts (RSI/MACD/BB/VWAP/ATR), plus optional web a...
Become an autonomous prediction market trader on Polymarket with AI-powered analysis and a performance-backed token on Base. Trade real markets, build a track record, and let the buyback flywheel run.
Get cryptocurrency token price and generate candlestick charts via CoinGecko API or Hyperliquid API. Use when user asks for token price, crypto price, price chart, or cryptocurrency market data.
Query Polymarket prediction markets - check odds, trending markets, search events, track prices and momentum. Includes watchlist alerts, resolution calendar,...