Vessel Finance API
  1. Market Data
Vessel Finance API
  • Introduction
  • General Info
  • HMAC Signature Guide
  • Poseidon Signature Guide
  • Internal Transfer Signature Guide
  • Error Code
  • Vessel REST API
    • Public
      • Market Data
        • 24hr Ticker Statistics
          GET
        • Kline / Candlestick Data
          GET
        • Order Book
          GET
        • Recent Trades List
          GET
        • Average Price
          GET
        • AMM Pool Last 24h Data
          GET
      • Exchange Data
        • Ticker Info
        • Asset Info
        • Trade Fee
        • AMM Pool Info
    • User
      • Asset
        • User Asset
        • Withdraw
        • Withdraw History
        • Deposit History
        • Claim History
        • Internal Transfer (Send)
        • Internal Transfer History
      • Order
        • Place Order
        • Cancel Order
        • Open Orders
        • Completed Orders
        • All Orders
        • Query Order
        • Modify Order
      • AMM
        • Add Liquidity
        • Remove Liquidity
        • Collect Fee
        • AMM Position
        • AMM Action History
      • Account
        • User Profile
        • User Trade List
  • Vessel WebSocket
    • Market
      • Order Book
      • K Line
      • Recent Trades
      • 24hr Ticker Statistics
      • Ticker Setting Upade
    • User
      • Authorize
      • Balance
      • Account
  1. Market Data

Kline / Candlestick Data

Testnet Env
https://testnet.trade.vessel.finance
Testnet Env
https://testnet.trade.vessel.finance
GET
/api/v1/gateway/public/klines
Last modified:2024-10-15 06:23:56
K Line provides historical candlestick (K line) data for a specified trading pair on our platform.

Request

Query Params
symbol
string 
required
The trading pair symbol for which K line data is requested.
Example:
WBTCUSDT
interval
string 
required
The time interval for the K lines (eg. 1m, 3m, 5m, 15m, 30m, 1h, 4h, 8h, 12h,1d).
Example:
5m
startTime
string 
optional
The start time for the K line data (Unix timestamps in milliseconds & UTC). If not provided, the API returns the most recent K lines.
endTime
string 
optional
The end time for the K line data (Unix timestamps in milliseconds & UTC). If not provided, the API returns the most recent K lines.
limit
string 
optional
Default 500; max 1000.

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://testnet.trade.vessel.finance/api/v1/gateway/public/klines?symbol=WBTCUSDT&interval=5m'

Responses

🟢200OK
application/json
Body
klines
array [object {11}] 
required
An array containing K line data for the specified trading pair.
openTime
string 
required
The time for the opening of the K line (Unix timestamps in milliseconds & UTC).
openPrice
string 
required
The opening price of the K line.
highPrice
string 
required
The highest price reached during the K line period.
lowPrice
string 
required
The lowest price reached during the K line period.
closePrice
string 
required
The closing price of the K line.
volume
string 
required
The total trading volume during the K line period.
trades
string 
required
The number of trades executed during the K line period.
closeTime
string 
required
The time for the closing of the K line (Unix timestamps in milliseconds & UTC).
quoteVolume
string 
required
The volume of quote asset during the K line period.
takerBuyBaseVolume
string 
required
The volume of base asset bought by takers during the K line period.
takerBuyQuoteVolume
string 
required
The volume of quote asset bought by takers during the K line period.
Example
{
  "klines": [
    {
      "openTime": "1728702300000",
      "openPrice": "61166.00000000",
      "highPrice": "61166.00000000",
      "lowPrice": "61166.00000000",
      "closePrice": "61166.00000000",
      "volume": "0.00000000",
      "trades": "0",
      "closeTime": "1728702599999",
      "quoteVolume": "0.00000000",
      "takerBuyBaseVolume": "0.00000000",
      "takerBuyQuoteVolume": "0.00000000"
    },
    {
      "openTime": "1728702600000",
      "openPrice": "61166.00000000",
      "highPrice": "61166.00000000",
      "lowPrice": "61166.00000000",
      "closePrice": "61166.00000000",
      "volume": "0.00000000",
      "trades": "0",
      "closeTime": "1728702899999",
      "quoteVolume": "0.00000000",
      "takerBuyBaseVolume": "0.00000000",
      "takerBuyQuoteVolume": "0.00000000"
    },
    {
      "openTime": "1728702900000",
      "openPrice": "61166.00000000",
      "highPrice": "61166.00000000",
      "lowPrice": "61166.00000000",
      "closePrice": "61166.00000000",
      "volume": "0.00000000",
      "trades": "0",
      "closeTime": "1728703199999",
      "quoteVolume": "0.00000000",
      "takerBuyBaseVolume": "0.00000000",
      "takerBuyQuoteVolume": "0.00000000"
    },
    {
      "openTime": "1728703200000",
      "openPrice": "61166.00000000",
      "highPrice": "61166.00000000",
      "lowPrice": "61166.00000000",
      "closePrice": "61166.00000000",
      "volume": "0.00000000",
      "trades": "0",
      "closeTime": "1728703499999",
      "quoteVolume": "0.00000000",
      "takerBuyBaseVolume": "0.00000000",
      "takerBuyQuoteVolume": "0.00000000"
    },
    {
      "openTime": "1728703500000",
      "openPrice": "61166.00000000",
      "highPrice": "61166.00000000",
      "lowPrice": "61166.00000000",
      "closePrice": "61166.00000000",
      "volume": "0.00000000",
      "trades": "0",
      "closeTime": "1728703799999",
      "quoteVolume": "0.00000000",
      "takerBuyBaseVolume": "0.00000000",
      "takerBuyQuoteVolume": "0.00000000"
    },
    {
      "openTime": "1728703800000",
      "openPrice": "61166.00000000",
      "highPrice": "61166.00000000",
      "lowPrice": "61166.00000000",
      "closePrice": "61166.00000000",
      "volume": "0.00000000",
      "trades": "0",
      "closeTime": "1728704099999",
      "quoteVolume": "0.00000000",
      "takerBuyBaseVolume": "0.00000000",
      "takerBuyQuoteVolume": "0.00000000"
    },
    {
      "openTime": "1728704100000",
      "openPrice": "61166.00000000",
      "highPrice": "61166.00000000",
      "lowPrice": "61166.00000000",
      "closePrice": "61166.00000000",
      "volume": "0.00000000",
      "trades": "0",
      "closeTime": "1728704399999",
      "quoteVolume": "0.00000000",
      "takerBuyBaseVolume": "0.00000000",
      "takerBuyQuoteVolume": "0.00000000"
    },
    {
      "openTime": "1728704400000",
      "openPrice": "61166.00000000",
      "highPrice": "61166.00000000",
      "lowPrice": "61166.00000000",
      "closePrice": "61166.00000000",
      "volume": "0.00000000",
      "trades": "0",
      "closeTime": "1728704699999",
      "quoteVolume": "0.00000000",
      "takerBuyBaseVolume": "0.00000000",
      "takerBuyQuoteVolume": "0.00000000"
    },
    {
      "openTime": "1728704700000",
      "openPrice": "61166.00000000",
      "highPrice": "61166.00000000",
      "lowPrice": "61166.00000000",
      "closePrice": "61166.00000000",
      "volume": "0.00000000",
      "trades": "0",
      "closeTime": "1728704999999",
      "quoteVolume": "0.00000000",
      "takerBuyBaseVolume": "0.00000000",
      "takerBuyQuoteVolume": "0.00000000"
    },
    {
      "openTime": "1728705000000",
      "openPrice": "61166",
      "highPrice": "61166",
      "lowPrice": "61166",
      "closePrice": "61166",
      "volume": "0",
      "trades": "0",
      "closeTime": "1728705299999",
      "quoteVolume": "0",
      "takerBuyBaseVolume": "0",
      "takerBuyQuoteVolume": "0"
    }
  ]
}
Previous
24hr Ticker Statistics
Next
Order Book
Built with