Get prices for a pair

get

https://api.coinotc.com/v1/prices/{pair}

Returns the current order book prices for a trading pair enabled for the
authenticated counterparty.

Prices are spread-adjusted: bids reflect what the client receives when selling
base currency, and offers reflect what the client pays when buying base currency.
Up to 5 levels are returned per side.

Pair format

The pair path parameter accepts the following formats — all are normalized
to BASE-QUOTE internally:

Input	Normalized
`USDT-EUR`	`USDT-EUR`
`USDT/EUR`	`USDT-EUR`
`USDT_EUR`	`USDT-EUR`

Error codes

HTTP	`detail`	Cause
`400`	`INVALID_PAIR`	Pair format is invalid (missing `-`)
`403`	`PAIR_NOT_ENABLED`	Pair is not enabled for this account
`404`	`PAIR_ROUTE_NOT_FOUND`	No liquidity route configured for this pair
`503`	`NO_DATA`	No order book data available yet
`503`	`NO_LIQUIDITY`	Order book is empty on both sides

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

`detail`	Cause
`MISSING_HMAC_HEADERS`	One or more required headers are absent
`INVALID_TS`	Timestamp format is invalid
`TS_OUT_OF_WINDOW`	Timestamp is outside the ±60 s skew window
`INVALID_SIGNATURE`	Signature does not match

`detail`	Cause
`NO_DATA`	No order book snapshot has been received yet
`NO_LIQUIDITY`	Order book exists but both sides are empty

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Current spread-adjusted prices for the requested pair.

400Invalid pair format.

401Missing or invalid HMAC authentication. detailCauseMISSING_HMAC_HEADERSOne or more required headers are absentINVALID_TSTimestamp format is invalidTS_OUT_OF_WINDOWTimestamp is outside the ±60 s skew windowINVALID_SIGNATURESignature does not match

403Authentication passed but the pair is not enabled for this account, or the account itself is not authorized.

404No liquidity route is configured for this pair.

422Request validation error.

503Liquidity data is temporarily unavailable. detailCauseNO_DATANo order book snapshot has been received yetNO_LIQUIDITYOrder book exists but both sides are empty