# Finance and prediction markets (/docs/use-cases/finance-and-prediction-markets) Read market prices, company news and what prediction markets expect, next to social signals. Pull a stock's price and its latest headlines, read what prediction markets expect on a topic, and set both beside what people are saying. All of it comes through one key, in JSON you can chart directly. ## Start with a template - [A stock](/docs/templates.md#jobs-and-finance): A quote and the news for one instrument, as a ready program. - [Prediction markets](/docs/polymarket.md): Search Polymarket events and read each outcome ## Run your first request This asks Polymarket what it expects about the bitcoin halving. The call runs several related searches for you and keeps only the events on topic. **cURL** ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/polymarket/research?query=bitcoin%20halving&limit=20" \ -H "x-api-key: sc_your_key_here" ``` **Python** ```python title="Python" import requests response = requests.get( "https://www.socialcrawl.dev/v1/polymarket/research", params={"query": "bitcoin halving", "limit": 20}, headers={"x-api-key": "sc_your_key_here"}, ) for event in response.json()["data"]["items"]: print(event["title"], event["volume"]) ``` **TypeScript** ```typescript title="TypeScript" const url = new URL("https://www.socialcrawl.dev/v1/polymarket/research"); url.searchParams.set("query", "bitcoin halving"); url.searchParams.set("limit", "20"); const response = await fetch(url, { headers: { "x-api-key": "sc_your_key_here" } }); const { data } = await response.json(); for (const event of data.items) { console.log(event.title, event.volume); } ``` Each event carries its markets, and each market its outcomes and their prices. A price runs from 0 to 1, so `0.32` reads as a 32% implied probability. This call costs 5 credits. To see what the call costs first, pass the same parameters to `GET /v1/utility/estimate` with `id=polymarket/research`, which is free. [Endpoint pricing](/docs/endpoint-pricing.md) lists every call. For a single lookup with your own query, use `/v1/polymarket/search` instead. It runs the query once and returns what matches. ## How it works 1. **Pull** a quote and the latest headlines for a ticker with `/v1/finance/quote` and `/v1/finance/news`. A quote takes `TICKER:EXCHANGE`, such as `GOOGL:NASDAQ`, or a pair such as `BTC-USD`. One call returns the price, the fundamentals and the company profile. If you only know the company name, `/v1/finance/ticker-search` finds the exact `keyword` to send. 2. **Read** what prediction markets expect on the same subject with `/v1/polymarket/research`. 3. **Compare** both with what people say on social platforms, using one [search across platforms](/docs/search/everywhere.md). ## Why teams choose SocialCrawl **Markets, news and conversation under one key.** A quote, a headline and a social post each come back in a documented shape, so one pipeline reads them all. See the [quote schema](/docs/schema/quote.md). **Prediction markets show what people bet.** Every outcome has a price, its trading volume and how the price has moved. The [Polymarket guide](/docs/polymarket.md) shows how to read them. **Official spending data sits beside it.** Household and tourism spending by country, and US federal spending and contracts, come from official public sources. See the [Economy guide](/docs/economy.md). ## Related - [Market research](/docs/use-cases/market-research.md): Read what people say about a topic across platforms and countries. - [Trend detection](/docs/use-cases/trend-detection.md): Watch trending feeds, sounds and hashtags as they rise. - [Alternative data](/solutions/alternative-data): Social data shaped for models and research teams. SocialCrawl returns public market data and prediction-market prices as information, not investment advice.