# Market data

Endpoints to get prices, indicative rates, benchmark rates, and trade ticker rates.

## Get spot rate by symbol

 - [GET /v2/rates/spot](https://docs.fxinside.net/openapi/integral-api-reference/rest/market-data/getspotrate.md): Get real-time, top-of-book spot bid and offer rates for a given symbol. Returns an aggregated list of rates, which may include prices from multiple liquidity providers or external market data sources.

## Get spot rate by type and symbol

 - [GET /v2/rates/spot/{type}](https://docs.fxinside.net/openapi/integral-api-reference/rest/market-data/getspotratebytype.md): Get real-time spot bid and offer rates by rate type and symbol. Returns an aggregated list of rates, which may include prices from multiple liquidity providers or external market data sources.

## Get spot rate by type and symbol for organization

 - [GET /v2/rates/spot/{type}/{org}](https://docs.fxinside.net/openapi/integral-api-reference/rest/market-data/getspotratebytypeorg.md): Get real-time spot bid and offer rates by rate type and symbol from liquidity providers for an organization. Returns an aggregated list of rates, which may include prices from multiple liquidity providers or external market data sources.

## Get market data

 - [GET /marketdataset](https://docs.fxinside.net/openapi/integral-api-reference/rest/market-data/getmarketdataset.md): Get rates from market data sets (MDSs) managed by the Integral Pricing engine.

The MDS workflow determines the parameters you need to send and the type of rates you receive.

* Regular workflow
* End-of-day workflow
* Fixed-period workflow

Regular workflow

A regular MDS contains active market rates.

Required parameter values for regular rates:

* : you must include the ID of a regular MDS.
* : you must omit this parameter for regular rates. If you specify the  of a regular MDS and the  parameter, an error is returned.
* : you must include either  or . If neither is included, an error is returned.
* : you must include either  or . If neither is included, an error is returned.

#### Example: regular rates for a single currency pair, SPOT, for today's business date



#### Example: regular rates for multiple currency pairs, 1-week outright, for today's business date



End-of-day workflow

An end-of-day MDS contains reference rates and is active after a specific time, typically after the end of the business day.

Required parameter values for end-of-day rates:

* : you must include the ID of an end-of-day MDS.
* : you must omit this parameter for end-of-day rates. If you specify the  of a end-of-day MDS and the  parameter, an error is returned.
* : you must include either  or . If neither is included, an error is returned.
* : you must include either  or . If neither is included, an error is returned.

#### Example: end-of-date rates for a single currency pair, SPOT, for today's business date



#### Example: end-of-date rates for a single currency pair, SPOT, for a specific date



Fixed-period workflow

A fixed-period MDS contains rates generated at a specific time and that are active and valid during a specified time window with a start and end time.

Required parameter values for fixed-period rates:

* : you must include either  or . Do not include both. Specify the MDS ID for fixed-period rates from a specific fixed-period MDS.
* : you must include either  or . Do not include both. Specify the organization ID for rates from all fixed-period MDSs for the organization.

#### Example: fixed-period rates for a single currency pair, SPOT, for today's business date



#### Example: fixed-period rates for a single currency pair, SPOT, for a specific date, active during a specific time window



#### Example: all fixed-period MDSs for an organization, SPOT, for a specific date, active during a specific time window




## Get benchmark

 - [GET /v2/benchmark](https://docs.fxinside.net/openapi/integral-api-reference/rest/market-data/getbenchmark.md): Get the Integral FX benchmark rate for a given symbol.

## Get ticker

 - [GET /v2/ticker](https://docs.fxinside.net/openapi/integral-api-reference/rest/market-data/getticker.md): Get the last traded price for a given symbol.