Latest data

GET 
/v1/orderbooks/:symbol_id/latest

Get latest order book snapshots for a specific symbol, returned in time descending order.

info

The historical order book data via the REST API is currently limited by a number of updates and to the maximum number of 20 levels.

Request

Path Parameters

symbol_id stringrequired

Symbol identifier of requested timeseries (from the Metadata -> Symbols)

Query Parameters

limit int32

Default value: 100

Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)

limit_levels int32

Maximum amount of levels from each side of the book to include in response (optional)

Responses

200

successful operation

text/plain

Schema

Schema

• Array [

symbol_id stringnullable

The symbol identifier.

time_exchange date-time

The exchange time of the order book.

time_coinapi date-time

The CoinAPI time when the order book was received.

asks nullable

The asks made by market makers.

bids nullable

The bids made by market makers.

• ]

Example (from schema)

[
  {
    "symbol_id": "string",
    "time_exchange": "2024-11-12T12:17:30.494Z",
    "time_coinapi": "2024-11-12T12:17:30.494Z"
  }
]

Example response

[
  {
    "symbol_id": "BITSTAMP_SPOT_BTC_USD",
    "time_exchange": "2013-09-28T22:40:50.0000000Z",
    "time_coinapi": "2017-03-18T22:42:21.3763342Z",
    "asks": [
      {
        "price": 456.35,
        "size": 123
      },
      {
        "price": 456.36,
        "size": 23
      }
    ],
    "bids": [
      {
        "price": 456.1,
        "size": 42
      },
      {
        "price": 456.09,
        "size": 5
      }
    ]
  }
]

application/json

Schema

Schema

• Array [

symbol_id stringnullable

The symbol identifier.

time_exchange date-time

The exchange time of the order book.

time_coinapi date-time

The CoinAPI time when the order book was received.

asks nullable

The asks made by market makers.

bids nullable

The bids made by market makers.

• ]

Example (from schema)

[
  {
    "symbol_id": "string",
    "time_exchange": "2024-11-12T12:17:30.495Z",
    "time_coinapi": "2024-11-12T12:17:30.495Z"
  }
]

Example response

[
  {
    "symbol_id": "BITSTAMP_SPOT_BTC_USD",
    "time_exchange": "2013-09-28T22:40:50.0000000Z",
    "time_coinapi": "2017-03-18T22:42:21.3763342Z",
    "asks": [
      {
        "price": 456.35,
        "size": 123
      },
      {
        "price": 456.36,
        "size": 23
      }
    ],
    "bids": [
      {
        "price": 456.1,
        "size": 42
      },
      {
        "price": 456.09,
        "size": 5
      }
    ]
  }
]

text/json

Schema

Schema

• Array [

symbol_id stringnullable

The symbol identifier.

time_exchange date-time

The exchange time of the order book.

time_coinapi date-time

The CoinAPI time when the order book was received.

asks nullable

The asks made by market makers.

bids nullable

The bids made by market makers.

• ]

Example (from schema)

[
  {
    "symbol_id": "string",
    "time_exchange": "2024-11-12T12:17:30.495Z",
    "time_coinapi": "2024-11-12T12:17:30.495Z"
  }
]

Example response

[
  {
    "symbol_id": "BITSTAMP_SPOT_BTC_USD",
    "time_exchange": "2013-09-28T22:40:50.0000000Z",
    "time_coinapi": "2017-03-18T22:42:21.3763342Z",
    "asks": [
      {
        "price": 456.35,
        "size": 123
      },
      {
        "price": 456.36,
        "size": 23
      }
    ],
    "bids": [
      {
        "price": 456.1,
        "size": 42
      },
      {
        "price": 456.09,
        "size": 5
      }
    ]
  }
]

application/x-msgpack

Schema

Schema

• Array [

symbol_id stringnullable

The symbol identifier.

time_exchange date-time

The exchange time of the order book.

time_coinapi date-time

The CoinAPI time when the order book was received.

asks nullable

The asks made by market makers.

bids nullable

The bids made by market makers.

• ]

Example (from schema)

[
  {
    "symbol_id": "string",
    "time_exchange": "2024-11-12T12:17:30.495Z",
    "time_coinapi": "2024-11-12T12:17:30.495Z"
  }
]

Example response

[
  {
    "symbol_id": "BITSTAMP_SPOT_BTC_USD",
    "time_exchange": "2013-09-28T22:40:50.0000000Z",
    "time_coinapi": "2017-03-18T22:42:21.3763342Z",
    "asks": [
      {
        "price": 456.35,
        "size": 123
      },
      {
        "price": 456.36,
        "size": 23
      }
    ],
    "bids": [
      {
        "price": 456.1,
        "size": 42
      },
      {
        "price": 456.09,
        "size": 5
      }
    ]
  }
]

Loading...

Was this section helpful?

• 1
• 2
• 3
• 4
• 5