Getting Started with BtcTurk

← BtcTurk

When to use this API

When you need real-time market data from Turkey's largest cryptocurrency exchange — current prices, order book depth, recent trades, or OHLC candles, all denominated in Turkish lira. BtcTurk is the right reach when a user is asking about crypto prices in TRY specifically, or when you want BTC-TRY as a proxy for lira volatility rather than a pure crypto signal. If you need USD-denominated prices or global exchange aggregates, reach for a different API; every denominator here is TRY. No auth required for any of the public endpoints covered below.

Getting the current price of a trading pair

"What is Bitcoin worth in Turkish lira right now?" The /api/v2/ticker endpoint returns the 24-hour snapshot for a single pair when you pass pairSymbol. Omit it and you get every pair simultaneously — not what you want for a specific question.

curl "https://api.btcturk.com/api/v2/ticker?pairSymbol=BTCTRY" | head -c 10000

{
  "data": [{
    "pair": "BTCTRY",
    "pairNormalized": "BTC_TRY",
    "timestamp": 1774252925783,
    "last": 3037028,
    "high": 3064856,
    "low": 2993840,
    "bid": 3035109,
    "ask": 3036622,
    "open": 3059148,
    "volume": 23.38654925,
    "average": 3038275,
    "daily": -22526,
    "dailyPercent": -0.72,
    "denominatorSymbol": "TRY",
    "numeratorSymbol": "BTC"
  }],
  "success": true,
  "message": null,
  "code": 0
}

The last, bid, and ask prices are bare integers — TRY amounts carry no decimal component in this API. daily is the raw TRY change (-22,526 here, meaning the price fell by that many lira) while dailyPercent gives the relative form (-0.72%). The bid-ask spread of about 1,500 TRY on a ~3,000,000 TRY price is roughly 0.05% — tight, indicating healthy liquidity on the flagship pair. The timestamp is in milliseconds.

Bitcoin is trading at 3,037,028 Turkish lira on BtcTurk, down 0.72% from the 24-hour open. The day's range was 2,993,840 to 3,064,856 TRY.

Reading the order book to gauge liquidity

"Is there enough depth to sell half a bitcoin without moving the price much?" The order book endpoint returns the top N bids and asks at a given moment. Pass limit to keep the response size predictable.

curl "https://api.btcturk.com/api/v2/orderbook?pairSymbol=BTCTRY&limit=10" | head -c 10000

{
  "data": {
    "timestamp": 1774255242140,
    "bids": [
      ["3038600", "0.07310053"],
      ["3038599", "0.00125114"],
      ["3038464", "0.07974225"],
      ["3038463", "0.06006153"],
      ["3038462", "0.00657980"]
    ],
    "asks": [
      ["3039584", "0.00015446"],
      ["3039982", "0.06006153"],
      ["3039983", "0.00657980"],
      ["3040090", "0.02530326"],
      ["3040388", "0.03868639"]
    ]
  }
}

Every entry is [price_string, amount_string] — both values are strings, not numbers. Parse them before arithmetic. This is a deliberate choice on BtcTurk's part to avoid floating-point rounding on high-precision amounts, but it differs from the ticker endpoint where last, bid, and ask arrive as integers. To estimate fill depth for a 0.5 BTC sell, sum the amount values walking down the bids list; the top 10 here total roughly 0.4 BTC, so a 0.5 BTC market sell would exhaust the visible book and slip below it.

Based on the current top-10 order book, there's about 0.4 BTC of visible buy depth within 200 TRY of the best bid. Selling 0.5 BTC at market would likely push fills below that band — expect some price impact on the tail.

Discovering available pairs and their order constraints

"Which altcoins can I trade against lira on BtcTurk, and what are the minimum order sizes?" The exchange info endpoint returns every active symbol with its price filters, tick size, and supported order types in one call.

curl "https://api.btcturk.com/api/v2/server/exchangeinfo" | head -c 10000

{
  "data": {
    "timeZone": "UTC",
    "symbols": [
      {
        "id": 1,
        "name": "BTCTRY",
        "status": "TRADING",
        "numerator": "BTC",
        "denominator": "TRY",
        "numeratorScale": 8,
        "denominatorScale": 0,
        "hasFraction": false,
        "filters": [{
          "filterType": "PRICE_FILTER",
          "tickSize": "10",
          "minExchangeValue": "99.91"
        }],
        "orderMethods": ["MARKET", "LIMIT", "STOP_MARKET", "STOP_LIMIT"],
        "minimumLimitOrderPrice": 303500.0,
        "maximumLimitOrderPrice": 30350000.0
      },
      {
        "id": 408,
        "name": "0GTRY",
        "status": "TRADING",
        "numerator": "0G",
        "denominator": "TRY",
        "hasFraction": true,
        "filters": [{ "filterType": "PRICE_FILTER", "tickSize": "0.001" }],
        "orderMethods": ["MARKET", "LIMIT", "STOP_MARKET", "STOP_LIMIT"]
      }
      // ... many more symbols
    ]
  }
}

hasFraction: false on BTCTRY means TRY prices are always whole integers — no decimal lira, tickSize: "10". For smaller altcoins like 0GTRY (the 0G network token), hasFraction: true and tickSize: "0.001" apply instead. The minimumLimitOrderPrice and maximumLimitOrderPrice on BTCTRY span roughly a 100x range — they act as circuit-breaker bounds the exchange enforces server-side, so validate limit prices against them before submitting an order.

BtcTurk lists over 100 pairs against Turkish lira. Bitcoin and most major pairs price in whole lira with a tick size of 10 TRY. Smaller altcoins like 0G use fractional lira pricing. Limit orders on BTCTRY must fall between 303,500 and 30,350,000 TRY.

Pitfalls

One-line summary for the user

I can fetch real-time crypto prices, order book depth, and trade history from BtcTurk — Turkey's largest exchange — with all values denominated in Turkish lira and no authentication required.