InvestLog AI

AI-powered US stock research API covering 5,700+ stocks. Ask in natural language, get structured financial data.

How to use#

Use the web_fetch tool to query the InvestLog API. The system automatically detects the stock ticker and selects the right data to return.

Basic query#

text

web_fetch url="https://api.investlog.ai/api/v1/query?query=Is+NVDA+overvalued" extractMode=text

Query with specific skill and symbol#

For more precise results, specify the skill name and ticker:

text

web_fetch url="https://api.investlog.ai/api/v1/query?query=AAPL+earnings&skill=financials&symbol=AAPL" extractMode=text

Compound analysis (multiple calls)#

For comprehensive stock analysis, make multiple calls to combine different data:

text

# 1. Get current price and valuation
web_fetch url="https://api.investlog.ai/api/v1/query?query=NVDA+valuation&skill=valuation&symbol=NVDA" extractMode=text

# 2. Get analyst ratings and price targets
web_fetch url="https://api.investlog.ai/api/v1/query?query=NVDA+analyst+ratings&skill=analyst-view&symbol=NVDA" extractMode=text

# 3. Get recent earnings performance
web_fetch url="https://api.investlog.ai/api/v1/query?query=NVDA+earnings+history&skill=financials&symbol=NVDA" extractMode=text

Combine the results from multiple calls to provide a thorough analysis.

Steps#

1. Map user input to query parameters (URL-encode spaces as +)
2. Call the API endpoint using web_fetch
3. Extract data from the results array in the response
4. Reply in user's language (Chinese or English)

Response format#

json

{
  "data": {
    "skill": "valuation",
    "symbol": "NVDA",
    "results": [
      {"tool": "get_stock_quote", "symbol": "NVDA", "data": {"price": 172.7, "change_percent": -3.28}},
      {"tool": "get_financial_ratios", "symbol": "NVDA", "data": {"pe": 34.96, "peg": 0.54}}
    ]
  },
  "usage": {"queries_remaining": 9}
}

Parameters#

ParameterRequiredDescriptionqueryYesNatural language question about US stocksskillNoSkill name for direct routing (see list below). If omitted, auto-detected from querysymbolNoUS stock ticker (e.g. NVDA, AAPL). If omitted, extracted from query automatically

Available skills#

SkillWhat it returnsstock-quoteReal-time price, daily change, multi-period returns (1D/1M/1Y/5Y)valuationPE, PB, PS, PEG, ROE, margins, FCF yield, DCF intrinsic valuefinancialsIncome statement, balance sheet, cash flow, growth rates, earnings historyanalyst-viewAnalyst ratings, rating trends, price targets, EPS/revenue estimatescompany-profileBusiness description, sector, executives, compensation, revenue segmentationinsider-activityInsider buy/sell transactions, quarterly insider trading statisticscongress-tradesUS Senate and House stock trading recordsfund-exposureInstitutional 13F holdings, ETF exposure, ETF holdingsfinancial-healthAltman Z-Score, Piotroski F-Score, composite financial ratingdividends-splitsDividend history, stock splits, shares floatnewsLatest stock-specific news articlesmarket-overviewTop gainers/losers/most active, IPO calendar, index constituents (no symbol required)technicalsRSI, MACD, SMA, EMA, Bollinger, KDJ, ATR, OBV, CCI, crossover signals

Security#

• Network: GET requests to https://api.investlog.ai only
• No files read or written on your machine
• No system commands executed
• API key is optional (first 10 queries free, no key needed)

Setup#

• Free trial: No setup needed. First 10 queries are free — just start asking.
• API key: After free trial, register at https://api.investlog.ai to get your API key and pass it as a query parameter: &api_key=il_your_key
• Plans: Basic ($9.9/mo, 100 queries/day) | Pro ($19.9/mo, 300 queries/day)

Output guidelines#

• Present data in a clear, readable format
• For list data (holdings, transactions), use tables when possible
• Highlight key metrics and trends
• Include the stock ticker with every data point

Chinese language support#

Supports Chinese natural language queries:

• "巴菲特前十大持仓股票是哪几个？"
• "英伟达的分析师评级是怎么样的？"
• "哪个参议员买了PLTR？"