---
title: "List symbols not yet mapped to a CoinAPI symbol_id for an exchange."
method: GET
path: "/v1/symbols/{exchange_id}/unmapped"
tags: ["Metadata"]
---

# List symbols not yet mapped to a CoinAPI symbol_id for an exchange.

`GET /v1/symbols/{exchange_id}/unmapped`

## Request

- Base URL: `https://rest.coinapi.io`
- URL: `https://rest.coinapi.io/v1/symbols/{exchange_id}/unmapped`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/coinapi/apis/coinapi-market-data-rest-api/docs/v1/symbols/:exchange_id/unmapped/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns raw exchange symbols that MarketAccess has received (KVP data available) but that
have not been mapped to a CoinAPI `symbol_id` yet. Since `symbol_id` is null for these rows,
use `symbol_id_exchange` (and `GET {exchange_id}/by-exchange-symbol/{exchange_symbol_id}`) to
reference them. The `raw_kvp` field contains the raw exchange payload as received.

## Path parameters

- `exchange_id` string, required

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

successful operation

- MarketDataMetadataSymbol[]
  - `symbol_id` string, nullable: The symbol identifier.
  - `exchange_id` string, nullable: The exchange identifier.
  - `symbol_type` string, nullable: The symbol type.
  - `asset_id_base` string, nullable: The base asset identifier.
  - `asset_id_quote` string, nullable: The quote asset identifier.
  - `asset_id_unit` string, nullable: The unit asset identifier.
  - `future_contract_unit` number, double, nullable: The contract unit for futures.
  - `future_contract_unit_asset` string, nullable: The asset used as the unit for futures contract.
  - `future_delivery_time` string, date-time, nullable: The future delivery time for futures contract.
  - `option_type_is_call` boolean, nullable: Indicates whether the option type is a call.
  - `option_strike_price` number, double, nullable: The strike price for options.
  - `option_contract_unit` number, double, nullable: The contract unit for options.
  - `option_exercise_style` string, nullable: The exercise style for options. Possible values: AMERICAN, ASIAN, BARRIER, BERMUDAN, BINARY, EUROPEAN, EXOTIC.
  - `option_expiration_time` string, date-time, nullable: The expiration time for options.
  - `contract_delivery_time` string, date-time, nullable: The delivery time for contracts.
  - `contract_unit` number, double, nullable: The contract unit for contracts.
  - `contract_unit_asset` string, nullable: The asset used as the unit for contracts.
  - `contract_id` string, nullable: The contract identifier.
  - `contract_display_name` string, nullable: The display name of the contract.
  - `contract_display_description` string, nullable: The display description of the contract.
  - `data_start` string, nullable
  - `data_end` string, nullable
  - `data_quote_start` string, date-time, nullable: The start date of quote data.
  - `data_quote_end` string, date-time, nullable: The end date of quote data.
  - `data_orderbook_start` string, date-time, nullable: The start date of order book data.
  - `data_orderbook_end` string, date-time, nullable: The end date of order book data.
  - `data_trade_start` string, date-time, nullable: The start date of trade data.
  - `data_trade_end` string, date-time, nullable: The end date of trade data.
  - `index_id` string, nullable: The index identifier.
  - `index_display_name` string, nullable: The display name of the index.
  - `index_display_description` string, nullable: The display description of the index.
  - `volume_1hrs` number, double, nullable: The volume in the last 1 hour.
  - `volume_1hrs_usd` number, double, nullable: The volume in USD in the last 1 hour.
  - `volume_1day` number, double, nullable: The volume in the last 1 day.
  - `volume_1day_usd` number, double, nullable: The volume in USD in the last 1 day.
  - `volume_1mth` number, double, nullable: The volume in the last 1 month.
  - `volume_1mth_usd` number, double, nullable: The volume in USD in the last 1 month.
  - `price` number, double, nullable: The price.
  - `symbol_id_exchange` string, nullable: The symbol identifier in the exchange.
  - `asset_id_base_exchange` string, nullable: The base asset identifier in the exchange.
  - `asset_id_quote_exchange` string, nullable: The quote asset identifier in the exchange.
  - `price_precision` number, double, nullable: The price precision.
  - `size_precision` number, double, nullable: The size precision.
  - `raw_kvp` object, nullable: Key Value Pair store with raw data from the data source.
  - `future_is_inverse` boolean, nullable: Indicates whether the futures contract is inverse (coin-margined).
  - `future_is_quanto` boolean, nullable: Indicates whether the futures contract is quanto.
  - `volume_to_usd` number, double, nullable: Volume unit in USD.
  - `option_barrier_up_price` number, double, nullable: The up barrier price for barrier options.
  - `option_barrier_up_type` string, nullable: The up barrier type for barrier options. Possible values: EXPIRATION, IN, OUT.
  - `option_barrier_down_price` number, double, nullable: The down barrier price for barrier options.
  - `option_barrier_down_type` string, nullable: The down barrier type for barrier options. Possible values: EXPIRATION, IN, OUT.
  - `symbol_id_int` integer, nullable: The symbol identifier in integer immutable format, used to correlate data across different APIs.

---

[API](https://skmtc.dev/coinapi/apis/coinapi-market-data-rest-api.md) - [All operations](https://skmtc.dev/coinapi/apis/coinapi-market-data-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coinapi/apis/coinapi-market-data-rest-api/revisions/8e2d7b7d9f23?raw)