> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stophy.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Finance and crypto

> Get stock quotes, price history, and company profiles. Get crypto prices, trending coins, DEX pairs, new tokens, wallets, and token holders.

Get stock quotes, price history, and company profiles. Get crypto prices, trending coins, DEX pairs, new tokens, wallets, and token holders. See every field in the [Finance and crypto reference](/api-reference/endpoint/finance-quote), or try it in the [playground](https://stophy.dev/playground).

## Get live stock and ETF quotes

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.finance.quote({ symbols: ["AAPL", "MSFT", "NVDA"] });
  console.log(result.data.quotes);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.finance.quote(symbols=["AAPL", "MSFT", "NVDA"])
  print(result["data"]["quotes"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/finance/quote \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"symbols":["AAPL","MSFT","NVDA"]}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy finance quote --symbols AAPL,MSFT,NVDA
  ```
</CodeGroup>

The response:

```json theme={null}
{
  "success": true,
  "data": {
    "quotes": [
      {
        "symbol": "example",
        "name": "Example title",
        "type": "example",
        "exchange": "example",
        "currency": "USD",
        "marketState": "example",
        "price": 19.99,
        "change": 1,
        "changePercent": 1,
        "open": 1,
        "high": 1,
        "low": 1,
        "previousClose": 1,
        "volume": 1,
        "averageVolume": 1,
        "marketCap": 1,
        "fiftyTwoWeekHigh": 1,
        "fiftyTwoWeekLow": 1,
        "peRatio": 1,
        "forwardPeRatio": 1,
        "earningsPerShare": 1,
        "dividendYield": 1,
        "preMarketPrice": 19.99,
        "postMarketPrice": 19.99,
        "updatedAt": "2026-09-28T12:00:00.000Z"
      }
    ]
  },
  "creditsUsed": 1,
  "requestId": "c09a315a-34a3-432b-9f1f-a5da10bf48c5"
}
```

## Endpoints

| Endpoint | Cost |
| - | - |
| [Get live stock and ETF quotes](/api-reference/endpoint/finance-quote) | 1 credit |
| [Get a stock's price history](/api-reference/endpoint/finance-history) | 1 credit |
| [Search stocks and related news](/api-reference/endpoint/finance-search) | 1 credit |
| [Get a company's profile and key stats](/api-reference/endpoint/finance-profile) | 1 credit |
| [Get coin prices, market caps and volume](/api-reference/endpoint/crypto-coins) | 1 credit per 50 items, at least 1 credit |
| [Get a coin's price, supply and details](/api-reference/endpoint/crypto-coin) | 1 credit |
| [Get a coin's price history](/api-reference/endpoint/crypto-history) | 1 credit |
| [Get trending coins, categories and NFTs](/api-reference/endpoint/crypto-trending) | 1 credit |
| [Get crypto categories by market cap](/api-reference/endpoint/crypto-categories) | 1 credit |
| [Get the top gaining and losing coins](/api-reference/endpoint/crypto-movers) | 1 credit |
| [Get newly listed coins](/api-reference/endpoint/crypto-new) | 1 credit per 50 items, at least 1 credit |
| [Search DEX trading pairs](/api-reference/endpoint/crypto-dex-search) | 1 credit |
| [Get a DEX trading pair](/api-reference/endpoint/crypto-dex-pairs) | 1 credit |
| [Get a token and its DEX pairs](/api-reference/endpoint/crypto-dex-token) | 1 credit |
| [Get new and boosted tokens on DEXes](/api-reference/endpoint/crypto-dex-new) | 1 credit |
| [Get pump.fun coins](/api-reference/endpoint/crypto-pump-coins) | 1 credit per 50 items, at least 1 credit |
| [Get a pump.fun coin's details](/api-reference/endpoint/crypto-pump-coin) | 1 credit |
| [Get a pump.fun coin's trades](/api-reference/endpoint/crypto-pump-trades) | 1 credit per 100 items, at least 1 credit |
| [Get a wallet's balance, tokens and transactions](/api-reference/endpoint/crypto-wallet) | 1 credit per 25 items, at least 1 credit |
| [Get a token's top holders](/api-reference/endpoint/crypto-token-holders) | 1 credit per 50 items, at least 1 credit |
| [Get Binance announcements and listings](/api-reference/endpoint/crypto-binance-announcements) | 1 credit per 20 items, at least 1 credit |

## More ways to call it

### Get coin prices, market caps and volume

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.crypto.coins({ limit: 100 });
  console.log(result.data.coins);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.crypto.coins(limit=100)
  print(result["data"]["coins"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/crypto/coins \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"limit":100}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy crypto coins --limit 100
  ```
</CodeGroup>

### Get trending coins, categories and NFTs

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.crypto.trending({});
  console.log(result.data.coins);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.crypto.trending()
  print(result["data"]["coins"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/crypto/trending \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy crypto trending
  ```
</CodeGroup>

<Tip>Stock quotes accept several tickers in one call. Coin prices accept several coin ids.</Tip>