# Get portal market maps for all exchanges

`GET https://api.cryptohopper.com/v1/exchange/portal/map`

Part of [Exchanges](https://www.cryptohopper.com/api-documentation/api-reference/exchanges.md) in the Cryptohopper API reference.

Returns, for every live exchange, its market data portal key and a map between Cryptohopper market pairs and portal market pairs. Exchanges that are not on the portal get an empty key and an empty map.

No access token needed.

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `key` | string | no | Set to portal to key each market map by the portal pair. Any other value, or none, keys it by the Cryptohopper pair. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/exchange/portal/map" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": {
        "exchange_keys": {
            "crypto": "cryptocom",
            "binance": ""
        },
        "market_mapping": {
            "crypto": {
                "BTC/USDT": {
                    "ch_pair": "BTC/USDT",
                    "portal_pair": "BTC/USDT",
                    "base": "BTC",
                    "quote": "USDT"
                }
            },
            "binance": []
        }
    }
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.
