TickDB Documentation

​

What is TickDB?

​

Key Features

• Unified Access
  One API covering multiple markets and asset classes
• Real-time Data
  WebSocket-based streaming suitable for real-time market applications
• Full-Market Data Covers A-shares, Hong Kong stocks, and US stocks. A single REST request retrieves a complete snapshot of a selected market, while one WebSocket subscription continuously delivers real-time updates for every symbol in that market
• Multi-Market Support
  Forex, precious metals, indices, US stocks, HK stocks, A-shares, futures, and crypto
• Financials and Fundamentals Company profiles, financial statements, valuation, industry, dividends, and shareholder holdings
• Financial Calendar Earnings, dividends, splits, IPOs, and other events in dedicated categories
• Market Information Market status, trading sessions, trading calendar, and stock news
• Developer-Friendly
  REST APIs and WebSocket with clear interfaces, complete documentation, and practical examples
• AI-Friendly
  Structured real-time market, financial and fundamental, financial calendar, and market information inputs for company analysis, market monitoring, event tracking, and research assistance, with Skill, MCP, and CLI integration options

​

AI Integration

​

Skill

npx clawhub@latest install tickdb-market-data

• Zero signup, auto trial
• 72 core symbols free
• Works with any LLM

​

MCP

{
  "mcpServers": {
    "tickdb": {
      "type": "http",
      "url": "https://mcp.tickdb.ai/",
      "headers": {
        "X-TickDB-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

• Hosted at mcp.tickdb.ai, no self-deployment needed
• HTTPS + Header authentication
• Compatible with all MCP protocol clients
• 13 tools available, mapping 1:1 to REST API endpoints

​

CLI

npm install -g tickdb
tickdb config set-key YOUR_API_KEY
tickdb ticker BTCUSDT,XAUUSD,AAPL.US

• JSON / table dual output
• 16 native commands
• Bash-tool friendly, ideal for Agent workflows

​

llms.txt

https://docs.tickdb.ai/llms.txt

https://docs.tickdb.ai/llms-full.txt

​

Typical Use Cases

• Quantitative Trading
  Real-time market data source for algorithmic and strategy systems
• Market Dashboards
  Live price displays, asset tracking, and portfolio monitoring
• Trading Applications
  Building TradingView-like market interfaces and charting systems
• Data Analytics & Backtesting
  Historical market analysis, research, and strategy backtesting
• Fundamental Research Analyze companies using financial statements, valuation, industry data, and shareholder holdings
• Market Monitoring Track market changes and important events using full-market data, news, and the financial calendar
• Financial Services Integration
  Integration into existing trading platforms or financial infrastructure

​

Getting Started

• Quick Start - Get up and running in minutes
• Changelog - Version update history

​

REST API

​

Market Data APIs

• Available Symbols - Query supported trading symbols
• Ticker Snapshot - Real-time market ticker data
• Candlestick Data - Query candlesticks by interval and time range
• Latest Candlesticks - Get the latest candlestick for multiple symbols
• Order Book - Real-time order book depth data
• Tick-by-Tick Trades - Individual trade executions

​

Stock Market APIs

​

Full-Market Data

​

Stock Quotes and Metrics

​

Company Overview

​

Financial Statements

​

Valuation and Industries

​

Dividends and Corporate Actions

​

Shareholders and Institutional Holdings

​

Financial Calendar

​

Market Information

​

WebSocket Docs

​

Best Practices

​

Playground

​

Reference

• Data Specification - Symbol naming and formats
• Error Codes - Error codes and handling