Finam Trade API Skill

Setup

Prerequisites: $FINAM_API_KEY and $FINAM_ACCOUNT_ID must be already set in your environment.

If not configured by environment, follow these steps:

1. 1. Register and obtain your API Key from tokens page
2. Obtain your Account ID from your Finam account dashboard
3. Set environment variables:

CODEBLOCK0

Obtain JWT token before using the API:

CODEBLOCK1

Note: Token expires after 15 minutes. Re-run this command if you receive authentication errors.

Market assets

List Available Exchanges and Equities

Symbol Format: All symbols must be in ticker@mic format (e.g., SBER@MISX)
Base MIC Codes:

• - MISX - Moscow Exchange
• INLINECODE5 - RTS
• INLINECODE6 - NASDAQ/NGS
• INLINECODE7 - NASDAQ/NNS
• INLINECODE8 - New York Stock Exchange

View all supported exchanges with their MIC codes:

CODEBLOCK2

List stocks available on a specific exchange:

CODEBLOCK3

Get Asset Specification

Fetch detailed specification for a specific instrument (lot size, price step, decimals, trading schedule, etc.):

CODEBLOCK4

INLINECODE9 is optional but recommended — returns account-specific fields (margin, available quantity, etc.).

Search Assets

Search instruments by ticker glob pattern and/or name substring:

CODEBLOCK5

Available types: EQUITIES, FUTURES, BONDS, FUNDS, SPREADS, OTHER, CURRENCIES, OPTIONS, SWAPS, INLINECODE19

INLINECODE20 switches to GET /v1/assets/all with pagination (rate limit: 200 req/min). --active false includes archived instruments.

Get Top N Stocks by Volume

Pre-ranked lists of the 100 most liquid equities for each market, ordered by trading volume descending:

CODEBLOCK6

CODEBLOCK7

Account Management

Get Account Portfolio

Retrieve portfolio information including positions, balances, and P&L:

CODEBLOCK8

Market Data

Get Latest Quote

Retrieve current bid/ask prices and last trade:

CODEBLOCK9

Get Order Book (Depth)

View current market depth with bid/ask levels:

CODEBLOCK10

Get Recent Trades

List the most recent executed trades:

CODEBLOCK11

Get Historical Candles (OHLCV)

Retrieve historical price data with specified timeframe:

CODEBLOCK12

Available Timeframes:

Note: The max data depth is the maximum allowed range for end_time - start_time. If the range exceeds the limit, the API returns empty data.

Date Format (RFC 3339):

• - Format: YYYY-MM-DDTHH:MM:SSZ or INLINECODE38
• INLINECODE39 - Inclusive (interval start, included in results)
• INLINECODE40 - Exclusive (interval end, NOT included in results)
• Examples:

News

Get Latest Market News

Fetch and display the latest news headlines. No JWT token required.

Russian market news

CODEBLOCK13

US market news

CODEBLOCK14

Parameters:

• - Change [:10] to any number to control how many headlines to display

Order Management

IMPORTANT: 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.

Place Order

Order Types:

• - ORDER_TYPE_MARKET - Market order (executes immediately, no limit_price required)
• INLINECODE46 - Limit order (requires limit_price)

CODEBLOCK15

Parameters:

• - symbol - Instrument (e.g., SBER@MISX)
• INLINECODE50 - Number of shares/contracts
• INLINECODE51 - SIDE_BUY or INLINECODE53
• INLINECODE54 - ORDER_TYPE_MARKET or INLINECODE56
• INLINECODE57 - Only for ORDER_TYPE_LIMIT (omit for market orders)

Get Order Status

Check the status of a specific order:

CODEBLOCK16

Cancel Order

Cancel a pending order:

CODEBLOCK17

Volatility Scanner

Scans 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:

CODEBLOCK18

Arguments:

• - ru / us — market to scan (default: ru)
• INLINECODE62 — number of top results to display (default: 10)

Examples:

CODEBLOCK19

All scripts support --help for usage details (e.g. python3 scripts/volatility.py --help).

REST vs gRPC — When to Use Which

Use REST when:

• - Fetching historical OHLCV data for backtesting or analysis
• Retrieving account info, positions, balances, and trade history
• Searching instruments or fetching asset specifications
• Placing or cancelling a one-off order where 100–200 ms latency is acceptable
• Checking order status after placement

Use gRPC when:

• - Subscribing to real-time market data: quotes, order book, trade feed
• Processing live bar data (M1, M5) for signal generation in event-driven strategies
• Monitoring own orders and trades in real time via subscription
• Your strategy requires minimal latency for rapid order placement/cancellation
• Building long-running trading bots that need persistent, auto-reconnecting connections

For gRPC, use the FinamPy Python library (
pip install git+https://github.com/cia76/FinamPy.git).
Full usage reference: gRPC Python Reference