OTC Markets APIotcmarkets.com ↗
Access quotes, company profiles, compliance badges, news, and market screeners for 12,000+ OTC securities via the OTC Markets API.
What is the OTC Markets API?
This API covers over 12,000 OTC-listed securities across six endpoints, returning price quotes, company profiles, compliance badges, news feeds, and market movers. The get_stock_quote endpoint delivers fields like lastSale, bidPrice, askPrice, peRatio, and marketCap with a 15-minute delay, while get_company_badges exposes boolean compliance flags including isCaveatEmptor, isDark, and isDelinquent — signals that are otherwise tedious to collect at scale.
curl -X GET 'https://api.parse.bot/scraper/ad4d4a80-010c-46dc-aa7e-eed4a2b7502b/get_company_profile?symbol=OTCM' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace otcmarkets-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.otc_markets_api import OTCMarkets, Tier
otc = OTCMarkets()
# Fetch a company profile by symbol
company = otc.companies.get(symbol="OTCM")
print(company.name, company.city, company.website)
# Access nested securities
for sec in company.securities:
print(sec.symbol, sec.tier_name, sec.outstanding_shares)
# Get real-time quote for the company
quote = company.quote()
print(quote.last_sale, quote.percent_change, quote.volume, quote.market_cap)
# Check compliance badges
badges = company.badges()
print(badges.is_shell, badges.is_caveat_emptor, badges.verified_profile)
# Browse company news with auto-pagination
for article in company.news.list(page_size=5, limit=10):
print(article.title, article.release_date, article.source_description)
# Get top gainers for OTCQB tier
for advancer in otc.advancers.list(tier=Tier.QB, page_size=5, limit=10):
print(advancer.symbol, advancer.price, advancer.pct_change, advancer.tier_name)
# List all OTC symbols
for entry in otc.symbolentries.list(limit=20):
print(entry.symbol, entry.company_name, entry.venue)
Get detailed company profile for an OTC-listed company. Returns business description, contact information, key executives, securities details, and incorporation information.
| Param | Type | Description |
|---|---|---|
| symbolrequired | string | Stock ticker symbol (e.g., OTCM, GTII) |
{
"type": "object",
"fields": {
"name": "string, company name",
"securities": "array of security objects with symbol, cusip, tierName, outstandingShares",
"businessDesc": "string, full business description",
"premierDirectorList": "array of director objects with name, title, biography"
},
"sample": {
"data": {
"city": "New York",
"name": "OTC Markets Group Inc.",
"phone": "+1 (555) 012-3456",
"state": "NY",
"country": "United States",
"website": "http://www.otcmarkets.com",
"address1": "300 Vesey Street (One North End Ave)",
"securities": [
{
"cusip": "67106F108",
"symbol": "OTCM",
"tierName": "OTCQX U.S.",
"outstandingShares": 12003152
}
],
"businessDesc": "OTC Markets Group Inc. (OTCQX: OTCM) operates regulated markets for trading 12,000 U.S. and international securities.",
"premierDirectorList": [
{
"name": "John Doe",
"title": "Chairman",
"biography": "John Doe is the Chairman of OTC Markets Group Board of Directors."
}
]
},
"status": "success"
}
}About the OTC Markets API
Quotes and Company Fundamentals
The get_stock_quote endpoint accepts a symbol parameter and returns a snapshot that includes lastSale, previousClose, change, percentChange, volume, bidPrice, askPrice, marketCap, and peRatio. Quote data carries a 15-minute delay. The get_company_profile endpoint returns deeper fundamentals: a full businessDesc, an array of securities objects carrying cusip, tierName, and outstandingShares, plus a premierDirectorList with name, title, and biography fields for each director.
Compliance Badges and Risk Signals
The get_company_badges endpoint maps directly to the compliance indicators OTC Markets publishes for each security. It returns six boolean flags — isShell, isBankrupt, isDark, isDelinquent, isCaveatEmptor, and verifiedProfile — allowing you to filter or flag securities programmatically without scraping individual company pages.
News and Market Movers
get_company_news returns paginated press releases and news items for a given symbol, with each record including title, releaseDate, sourceDesc, and symbol. The page and page_size parameters control pagination; totalRecords and pages fields in the response let you iterate through the full result set. For market-wide screening, get_advancers returns the top gainers filtered by tier (QX, QB, DQ, or ALL), sorted by pctChange descending, with each record including price, shareVolume, and tierName.
Symbol Coverage
The list_symbols endpoint returns a flat array of every listed OTC security with its symbol (s), company name (c), venue (v), and tier ID (t). This is useful for building local lookup tables or validating symbols before calling other endpoints.
The OTC Markets API is a managed, monitored endpoint for otcmarkets.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when otcmarkets.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official otcmarkets.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Screen OTC penny stocks by filtering
get_advancersresults for the Pink tier (DQ) and sorting bypctChange. - Build a compliance dashboard that flags high-risk holdings using
isCaveatEmptor,isDark, andisDelinquentfromget_company_badges. - Track a watchlist's intraday movement by polling
get_stock_quoteforlastSale,volume, andpercentChange. - Aggregate executive biography data from
premierDirectorListinget_company_profilefor corporate governance research. - Monitor company press releases by paginating
get_company_newswithpageandpage_sizeand ingesting newreleaseDateentries. - Enumerate all 12,000+ OTC symbols via
list_symbolsto seed a securities database or validate ticker inputs. - Compare
outstandingSharesandtierNameacross multiple securities to study float and market-tier distribution.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does OTC Markets have an official developer API?+
How fresh is the quote data from `get_stock_quote`?+
get_stock_quote is delayed by 15 minutes. Fields like lastSale, bidPrice, askPrice, and volume reflect this delay. The endpoint is not suitable for latency-sensitive execution workflows, but it is adequate for research, screening, and display use cases.Does `get_company_badges` explain why a company received the Caveat Emptor designation?+
get_company_badges returns boolean flags only — isCaveatEmptor, isDark, isShell, isBankrupt, isDelinquent, and verifiedProfile — without explanatory text or timestamps for when a designation was applied. You can fork this API on Parse and revise it to add an endpoint that retrieves the associated compliance notes if that detail is available on the source.Can I retrieve historical price data or OHLCV charts through this API?+
get_stock_quote and company fundamentals, but does not expose historical OHLCV series or candlestick data. You can fork the API on Parse and revise it to add a historical pricing endpoint.How does pagination work on `get_company_news` and `get_advancers`?+
page and page_size as optional integer parameters. Each response includes currentPage, pages (total page count), and totalRecords, giving you everything needed to iterate through the full result set programmatically.