Investing.com quotes, watchlists and fair-value holdings
Investing.com: Stock Market is the Android markets terminal of Fusion Media Limited, the Nicosia (Cyprus) publisher behind the Investing.com portal. Retail investors and active traders watch live quotes on stocks, forex, crypto, indices, commodities and bonds, keep named watchlists and paper portfolios, scan economic, earnings, dividend and IPO calendars, read news and analysis, chat with Warren AI, and subscribe to InvestingPro for fair-value models and ProPicks. Price, percent and earnings alerts sit on those same instrument screens, and a country-edition picker swaps the homepage for local markets. The app is a global quote-and-research client — not a broker — competing with Yahoo Finance, TradingView and Bloomberg for the same retail desk.
Quoted pair_ID ticks pin last_numeric and last_dir on each instrument, while paper-portfolio rows carry AvgPrice, NetPL and StockSymbol. Watchlists return portfolio_id and pairs_data; dividend cards expose annualized_payout, dividend_yield and payout_ratio; earnings prints list eps_actual versus eps_forecast; calendar rows stamp event_actual against event_forecast. Fair-value cards add upside and nested analyst_target.
Research desks join ticks to holdings P&L, calendar bots fan actual-versus-forecast surprises, and wealth screens overlay dividend yield on a watchlist. openData Studio turns that quote, holdings and calendar surface into callable open data.
Screenshots
API surface
The endpoints and request/response examples below are reconstructed from the app's interface — illustrative, not a live capture.
Sign in
POST
/v1/auth/identity-exchangeosintExchanges a login Token and Type for a session Token, Uapi and Mobile used on later Bearer calls.
Auth: Unauthenticated. Body carries Token and Type; response Token is sent as Authorization: Bearer on later calls, with Uapi as the user-api handle.
- Token
- Type
- Uapi
- Mobile
POST /v1/auth/identity-exchange HTTP/1.1 Content-Type: application/json { "Token": "id-token-from-email-or-social", "Type": "email" }{ "Token": "eyJhbGciOiJIUzI1NiJ9...", "Uapi": "uapi_9f3a11c2", "Mobile": "+12025550123" }User data profile
GET
/v1/members/me/investor-profileosintReads the signed-in user profile: userId, email, firstName/lastName, token/proToken/uApi and InvestingPro flags.
Auth: Authorization: Bearer <token> from the sign-in response.
- proUserId
- permissions
- uApi
- token
- proToken
- userId
- firstName
- lastName
- imageUrl
- networkId
- isAnonymous
GET /v1/members/me/investor-profile HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...{ "proUserId": 880012, "permissions": [ "pro" ], "uApi": "uapi_9f3a11c2", "token": "eyJhbGciOiJIUzI1NiJ9...", "proToken": "pro_eyJhbGciOiJIUzI1NiJ9...", "userId": 44001122, "firstName": "Alex", "lastName": "Rivera", "email": "[email protected]", "imageUrl": "https://cdn.example.com/avatars/alex.png", "networkId": 1, "isAnonymous": 0 }Instrument details
GET
/v1/markets/instruments/{instrument_id}opendataLoads an instrument's pairs_attr: pair_ID, pair_symbol, pair_name, currency_in and decimal_precision for the quote header.
Auth: Optional Bearer from the sign-in response; public instrument pages load without a session.
- pair_ID
- currency_in
- exchange_flag
- pair_innerpage_header_subtext
- pair_name
- pair_symbol
- decimal_precision
- earning_alert
- change_precent
- screen_data
- pairs_attr
GET /v1/markets/instruments/6408 HTTP/1.1 Accept: application/json{ "screen_data": { "pairs_attr": { "pair_ID": 6408, "currency_in": "USD", "exchange_flag": "NYSE", "pair_innerpage_header_subtext": "New York Stock Exchange", "pair_name": "Apple Inc", "pair_symbol": "AAPL", "decimal_precision": 2, "earning_alert": "1", "change_precent": "+0.84" } } }Signed-in watchlist
GET
/v1/lists/watchlistsopenfinanceReturns the signed-in watchlist portfolios: portfolio_id, portfolio_name and pairs_data instrument rows.
Auth: Authorization: Bearer <token> from the sign-in response.
- portfolio_id
- portfolio_name
- portfolioType
- num_of_instruments
- number_of_instruments
- pairs_data
GET /v1/lists/watchlists HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...{ "portfolio_id": 102334, "portfolio_name": "Tech", "portfolioType": "watchlist", "num_of_instruments": "12", "number_of_instruments": "12", "pairs_data": [ { "pair_ID": 6408, "pair_symbol": "AAPL" } ] }Paper portfolio holdings
GET
/v1/portfolios/paper/holdingsopenfinanceReads paper-portfolio totals (DailyPLShort, MarketValueShort) and per-row Amount, AvgPrice, NetPL and StockSymbol.
Auth: Authorization: Bearer <token> from the sign-in response.
- DailyPLShort
- DailyPLPerc
- DailyPLColor
- CurrSign
- MarketValueShort
- Amount
- AvgPrice
- NetPL
- NetPLPerc
- StockSymbol
- pair_id
- OpenPrice
- last
- PositionMarketValue
- ExchangeName
- Name
- positionId
- leverage
GET /v1/portfolios/paper/holdings HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...{ "DailyPLShort": "+18.20", "DailyPLPerc": "0.38", "DailyPLColor": "green", "CurrSign": "$", "MarketValueShort": "4.87K", "positions": [ { "Amount": 25.0, "AvgPrice": 178.4, "NetPL": 412.5, "NetPLPerc": 8.47, "StockSymbol": "AAPL", "pair_id": 6408, "OpenPrice": 178.4, "last": 194.9, "PositionMarketValue": 4872.5, "ExchangeName": "NYSE", "Name": "Apple Inc", "positionId": 99102, "leverage": 1 } ] }Dividend summary
GET
/v1/markets/instruments/{instrument_id}/dividend-cardopendataReturns an instrument's dividend card: annualized_payout, dividend_yield, payout_ratio, five_year_dividend_growth and next_dividend_date.
Auth: Optional Bearer from the sign-in response.
- annualized_payout
- dividend_yield
- five_year_dividend_growth
- next_dividend_date
- payout_ratio
GET /v1/markets/instruments/6408/dividend-card HTTP/1.1 Accept: application/json{ "annualized_payout": 0.96, "dividend_yield": 0.49, "five_year_dividend_growth": 5.2, "next_dividend_date": "2026-11-13", "payout_ratio": 15.8 }Instrument earnings
GET
/v1/markets/instruments/{instrument_id}/earnings-printsopendataPages an instrument's earnings prints: eps_actual vs eps_forecast, revenue_actual vs revenue_forecast, keyed by cursor.
Auth: Optional Bearer from the sign-in response.
- cursor
- earnings
- date
- eps_actual
- eps_forecast
- report_month
- report_year
- revenue_actual
- revenue_forecast
GET /v1/markets/instruments/6408/earnings-prints?cursor=eyJwYWdlIjowfQ HTTP/1.1 Accept: application/json{ "cursor": "eyJwYWdlIjoxfQ", "earnings": [ { "date": "2026-01-29T21:00:00Z", "eps_actual": 2.4, "eps_forecast": 2.35, "report_month": 1, "report_year": 2026, "revenue_actual": 124300000000, "revenue_forecast": 123800000000 } ] }Company profile
GET
/v1/markets/instruments/{instrument_id}/profileopendataReturns company profile copy: business_summary, sector/industry ids, employees_number and contact_information (city, web, zip_code).
Auth: Optional Bearer from the sign-in response.
- business_summary
- contact_information
- city
- country
- phone
- street_address
- web
- zip_code
- employees_number
- equity_type
- industry
- industry_id
- industry_url_path
- sector
- sector_id
- sector_url_path
GET /v1/markets/instruments/6408/profile HTTP/1.1 Accept: application/json{ "business_summary": "Apple Inc. designs, manufactures and markets smartphones, personal computers and wearables.", "contact_information": { "city": "Cupertino", "country": "United States", "phone": "408-996-1010", "street_address": "One Apple Park Way", "web": "https://www.example.com", "zip_code": "95014" }, "employees_number": 164000, "equity_type": "ORD", "industry": "Computers, Phones & Household Electronics", "industry_id": 12, "industry_url_path": "computers-phones", "sector": "Technology", "sector_id": 4, "sector_url_path": "technology" }Economic calendar events
GET
/v1/calendar/macro-eventsopendataLists economic-calendar rows: event_attr_ID, event_actual vs event_forecast/event_previous, event_timestamp and the perliminary/sandclock flags.
Auth: Optional Bearer from the sign-in response.
- event_attr_ID
- event_previous
- event_forecast
- event_actual
- event_revised_from
- event_ref
- event_revised_color
- event_actual_color
- event_timestamp
- tentative
- perliminary
- sandclock
GET /v1/calendar/macro-events?from=2026-10-16&to=2026-10-23 HTTP/1.1 Accept: application/json{ "event_attr_ID": 772, "event_previous": "3.2%", "event_forecast": "3.1%", "event_actual": "3.0%", "event_revised_from": "3.2%", "event_ref": "NFP", "event_revised_color": "red", "event_actual_color": "green", "event_timestamp": 1729084800, "tentative": false, "perliminary": false, "sandclock": false }Fair value
POST
/v1/valuation/fair-valueopenfinanceReturns InvestingPro fair-value for a symbol: upside, uncertainty, nested analyst_target (values_range, targets_count) and locked.
Auth: Authorization: Bearer <token>; locked models require InvestingPro (proToken / permissions).
- upside
- uncertainty
- symbol
- price
- market_data
- analyst_target
- values_range
- targets_count
- fair_value_models_aggregate
- fair_value_models
- locked
POST /v1/valuation/fair-value HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiJ9... Content-Type: application/json { "symbol": "AAPL" }{ "upside": 12.4, "uncertainty": "medium", "symbol": "AAPL", "price": { "low": 210.0, "high": 245.0 }, "market_data": {}, "analyst_target": { "values_range": [ 220.0, 260.0 ], "targets_count": 38 }, "fair_value_models_aggregate": {}, "fair_value_models": [], "locked": false }Live quote ticks
GET
/v1/quotes/ticksopendataPulls a live last print for one or more pids: last_numeric, last_dir and low.
Auth: Unauthenticated public ticks; pair ids come from pair_ID / pid.
- pid
- last_dir
- last_numeric
- low
GET /v1/quotes/ticks?pids=6408 HTTP/1.1 Accept: application/json{ "pid": 6408, "last_dir": "green", "last_numeric": 194.91, "low": 193.2 }Quote websocket
GET
/v1/stream/quotesopendataStreams live quote frames over a websocket: pid, last_numeric, last_dir and low.
Auth: Unauthenticated WebSocket upgrade; subscribe with pid from the instrument pair_ID.
- pid
- last_dir
- last_numeric
- low
GET /v1/stream/quotes HTTP/1.1 Upgrade: websocket Connection: Upgrade{ "pid": 6408, "last_dir": "green", "last_numeric": 194.91, "low": 193.2 }
Data categories
- market quotes
- watchlists
- paper portfolios
- dividends
- earnings
- economic calendar
- fair value
- user profile
Where teams use this data
Watchlist tick fan-out
A research bot maps watchlist pairs_data pair_ID to livequote pid, then fires when last_numeric or last_dir on AAPL and peers crosses a desk band.
Paper-book P&L recon
A PMS diffs HoldingsDataItem Amount, AvgPrice and NetPL plus DailyPLShort / MarketValueShort against an internal blotter so paper books stay aligned overnight.
Calendar surprise alerts
A macro desk joins event_actual to event_forecast and event_previous on event_attr_ID rows and pages traders when event_actual_color flips on NFP-style prints.
Yield overlay on holdings
A wealth screen stamps dividend_yield, annualized_payout and next_dividend_date onto each StockSymbol, then ranks names by payout_ratio next to fair-value upside.
Frequently asked questions
What live quote fields does Investing.com stream?
Livequote events carry pid (the instrument pair_ID), last_numeric, last_dir and low. Instrument headers add pair_symbol, pair_name, currency_in and decimal_precision.
Can I read paper holdings and watchlists, not just quotes?
Yes. Signed-in watchlists return portfolio_id, portfolio_name and pairs_data. Paper-portfolio rows expose Amount, AvgPrice, NetPL, StockSymbol and pair_id, with DailyPLShort and MarketValueShort on the totals card.
How does Investing.com sign-in work?
The client posts Token and Type, then stores the returned Token, Uapi and Mobile. Later calls send Authorization: Bearer with that Token; UserProfile also carries userId, email, proToken and permissions.
Which calendar and corporate-action fields are available?
Economic-calendar rows include event_attr_ID, event_actual, event_forecast, event_previous and event_timestamp. Dividend summaries expose annualized_payout, dividend_yield, payout_ratio and next_dividend_date; earnings prints list eps_actual versus eps_forecast.
Apps similar to Investing.com: Stock Market
- TradingView — TradingView is a charting and social-trading app for stocks, crypto, forex and futures, with web, desktop and mobile clients and 100+ connected brokers.
- Yahoo Finance — Yahoo Finance is Yahoo's markets app for quotes, watchlists, news and portfolio tracking across stocks, ETFs, crypto and currencies.
- MetaTrader 5 — Forex, Stocks — MetaTrader 5 is MetaQuotes' multi-asset trading terminal for forex, CFDs and exchange names, with live quotes, charts and broker-connected order entry.
- Angel One: Stocks, Mutual Fund — Angel One is an India SEBI-regulated broker whose Android client places NSE/BSE/MCX orders and tracks demat holdings, unlike Investing.com's quote-and-research screens.
- Bloomberg — Bloomberg's mobile app delivers market data, news and watchlists from the same terminal franchise used by professional desks.
- eToro — eToro is a multi-asset brokerage for stocks, ETFs, CFDs and cryptoassets with copy trading, sitting on the execution side of the same retail markets Investing.com covers as data.
- MarketWatch — MarketWatch is Dow Jones' markets site and app for US quotes, news, economic calendars and personal watchlists.
- Seeking Alpha — Seeking Alpha is an investment-research network for stock analysis, earnings transcripts, quant ratings and portfolio tracking.
Topics
- Investing.com API
- Investing.com pair_ID quotes
- Investing.com watchlist portfolio_id
- Investing.com holdings NetPL
- Investing.com dividend_yield
- Investing.com eps_actual
- Investing.com economic calendar
- Investing.com fair value upside
Need this app's data API integrated?
We deliver scoped integrations for any named app — from USD 500 with source-code handoff, or hosted access billed per call. Tell us the data you need.
- NDA + SOW on every engagement
- Delivery in 3–7 days
- Payment only after acceptance
- Work scoped to authorized use