# Market data

The MoonPay Wallets market-data APIs provide token discovery, prices, charts, trading-pair data, wallet data, and Bitcoin lookups under `/v0/data/`. They complement the wallet SDK: querying an address does not create a wallet or authorize signing for it.

## Start from your backend

Most data operations require an **app secret key**. Keep it on your backend and expose only the results your application needs. See [API credentials](/get-started/rest-api/api-overview) for the app-key model.

Fetch the network catalog as a first authenticated request:

```bash
curl --fail-with-body https://x-api.moonpay.com/v0/data/networks/ \
  -H "X-API-Key: moon_sk_test_your_api_key"
```

Use the catalog's identifiers for data requests. Do not assume they are interchangeable with SDK CAIP-2 chain identifiers such as `eip155:1`.

## Find the right operation

| Task | API surface |
| --- | --- |
| Search tokens and read token details | `/v0/data/tokens/*` |
| Read token prices | `/v0/data/tokens/{address}/price` and `/v0/data/prices/` |
| Read token/pair charts and trades | `/v0/data/tokens/*` and `/v0/data/pairs/*` |
| Read wallet balances, stats, and activity | `/v0/data/wallets/*` |
| Discover trending tokens and market information | `/v0/data/discover/*` |
| Find network and exchange identifiers | `/v0/data/networks/` and `/v0/data/exchanges/` |
| Read Bitcoin balances, transactions, and UTXOs | `/v0/data/btc/wallets/{address}/*` |

The [API reference](/api-reference) lists each operation's query parameters, paging, and response shape. Supported data networks and assets can differ from the wallet SDK's [chain support](/wallets/chain-support).

## Browser-facing exception

`POST /v0/data/wallets/balances/bulk` accepts a publishable app key for bulk balance summaries, including wallet-import account discovery. It accepts at most 50 addresses and is limited to 20 requests per minute per app. Other data routes remain secret-key-only; this exception does not make the whole data API browser-accessible.

## Use data in an application

Preserve asset and network identity, display the response's units accurately, and handle empty results and provider errors. Market data and indexers can lag chain execution. Use a transaction receipt/status for execution success rather than treating an updated chart or balance response as confirmation.

* [Credentials and environments](/get-started/environments)
* [Wallets](/wallets/overview)
* [Swaps](/swaps/overview)
* [Yield protocol recipes](/recipes/yield/overview)