CoinTR

CoinTR

CoinTr API Information

CoinTr API Link: https://www.cointr.com/api-doc/common/domain

Base Endpoints

  • Base Endpoint: https://api.cointr.com

Common Error Codes

CoinTr API Link: https://www.cointr.com/api-doc/common/signature-samaple/interaction

  • 400 Bad Request – Invalid request format
  • 401 Unauthorized – Invalid API Key
  • 403 Forbidden – You don’t have permission to access the requested resource
  • 404 Not Found – Request not found
  • 429 Too Many Requests – Requests are too frequent and limited by the system
  • 500 Internal Server Error – A problem occurred on our server

If the request fails, the returned response usually contains an error message.

LIMITS

CoinTr API Link: https://www.cointr.com/api-doc/common/signature-samaple/interaction

Access Restriction

Interface rate limits are based on UID or IP. Detailed information can be found on the specific API documentation page. Frequency limit rules:

  • Each API endpoint’s rate limit is specified in the documentation page.
  • The rate limit of each API interface is calculated independently.
  • General rate limit is 6000/IP/Minute.

Timestamp

The ACCESS-TIMESTAMP unit in the HTTP request signature is in milliseconds. The request timestamp must be within 30 seconds of the API server time, otherwise the request is considered expired and will be rejected.

Frequency Limiting Rules

If requests are made too frequently, the system automatically limits them and returns the 429 Too Many Requests status code.

  • Public interface: For market information interfaces, the combined rate limit is a maximum of 20 requests per second.
  • Authorization interface: apikey is used to restrict calls to authorization interfaces; for frequency limiting rules, refer to each interface’s documentation.

Request Format

Currently, only two request methods are supported: GET and POST

  • GET: Parameters are passed to the server via query string in the path.
  • POST: Parameters are sent to the server in JSON format.

RCXT CoinTR API Information

There is 1 Base Endpoint for the CoinTR exchange:

  • apiUrl: api.cointr.com

Rate Limits

On the CoinTR exchange, the rate limit set for each endpoint is as follows:

Limit (1 saniye) Spot DepositWithdrawals FiatBuyFiatSell TransferIn Transfer Out Ticker
Fetch Balances 10 Request Weight
Fetch Orders 20 Request Weight
Fetch Trades 10 Request Weight
Fetch DepositWithdrawals 10 Request Weight 10 Request Weight 10 Request Weight 10 Request Weight
Ticker 20 Request Weight

Fetch Balances

Spot Balance
  • Uses apiUrl(api.cointr.com) as the Base Endpoint.
  • Uses /api/v2/spot/account/assets as the Endpoint.
  • Uses api/v1/coin-tr/balances as the RCXT Endpoint.

The user sends a GET request to query CoinTR wallet balances. This request must include the required header parameters:

  • apiKey, secretKey, and password values are taken from the header.

  • Limiter:

    • Each API endpoint has a specific Request Weight value assigned. The Request Weight value for Spot Balance is 10.

Response Example:

{
  "spot": [
    {
      "coin": "SHIB",
      "total": "41634.28"
    }
  ],
  "margin": null,
  "isolatedMargin": null,
  "futures": null,
  "earnings": null
}

Fetch Trades

Spot Trades
  • Uses apiUrl(api.cointr.com) as the Base Endpoint.

  • Uses /api/v2/spot/trade/fills as the Endpoint.

  • Uses api/v1/coin-tr/balances as the RCXT Endpoint.

  • apiKey, secretKey, and password values are taken from the header.

  • From query parameters, startTime, symbol, fromId, orderId, and type values are taken:

    • startTime: The date from which we want to fetch the data.
    • symbol: The trading pair symbol to fetch trades for. (e.g. BTCUSDT)
    • fromId: If we want to fetch a specific trade, enter the trade’s ID.
    • orderId: Used to filter by a specific order ID.
    • type: Available option is spot. Use spot for Spot Trades.
  • Limiter:

    • Each API endpoint has a specific Request Weight value assigned. The Request Weight value for Spot Trades is 10.
    • A maximum of 100 records can be fetched per page.

Response Example:

{
  "trades": [
    {
      "orderId": "226664511",
      "tradeId": "27082209",
      "isBuyer": false,
      "isMaker": false,
      "price": "0.07610000",
      "quantity": "199.90000000",
      "symbol": "ACAUSDT",
      "time": 1737552748284,
      "commission": "0.01521239",
      "commissionCurrency": "USDT"
    }
  ],
  "cursor": ""
}

Fetch Orders

Spot Orders
  • Uses apiUrl(api.cointr.com) as the Base Endpoint.

  • Uses /api/v2/spot/trade/history-orders as the Endpoint.

  • Uses api/v1/coin-tr/orders as the RCXT Endpoint.

  • apiKey, secretKey, and password values are taken from the header.

  • From query parameters, startTime, endTime, symbol, fromId, singleOrderId, type, and orderStatus values are taken:

    • startTime: The date from which we want to fetch the data.
    • endTime: The date until which we want to fetch the data.
    • symbol: The trading pair symbol to fetch orders for. (e.g. BTCUSDT)
    • fromId: If we want to fetch a specific order, enter the order’s ID.
    • singleOrderId: Used to filter by a single order ID.
    • type: Available value is spot. Use spot for Spot Open Orders.
    • orderStatus: If orderStatus is “open”, it fetches Open Orders; if “closed”, it fetches Closed Orders.
  • Limiter:

    • Each API endpoint has a specific Request Weight value assigned. The Request Weight value for Spot Orders is 20.
    • A maximum of 100 records can be fetched per page.
Spot Open Orders
  • Uses apiUrl(api.cointr.com) as the Base Endpoint.

  • Uses /api/v2/spot/trade/unfilled-orders as the Endpoint.

  • Uses api/v1/coin-tr/orders as the RCXT Endpoint.

  • apiKey, secretKey, and password values are taken from the header.

  • From query parameters, startTime, endTime, symbol, fromId, singleOrderId, type, and orderStatus values are taken:

    • startTime: The date from which we want to fetch the data.
    • endTime: The date until which we want to fetch the data.
    • symbol: The trading pair symbol to fetch orders for. (e.g. BTCUSDT)
    • fromId: If we want to fetch a specific order, enter the order’s ID.
    • singleOrderId: Used to filter by a single order ID.
    • type: Available value is spot. Use spot for Spot Open Orders.
    • orderStatus: If orderStatus is “open”, it fetches Open Orders; if “closed”, it fetches Closed Orders.
  • Limiter:

    • Each API endpoint has a specific Request Weight value assigned. The Request Weight value for Spot Open Orders is 20.
    • A maximum of 100 records can be fetched per page.

Response Example:

{
  "orders": [
 {
      "orderId": "904606155",
      "symbol": "PEPEUSDT",
      "type": "1",
      "price": "0.00001743",
      "side": "0",
      "time": 1734880852244,
      "status": "CLOSED",
      "executedQuantity": "339374",
      "quantity": "339374"
    }
  ],
  "cursor": ""
}

Fetch DepositsWithdrawals

Deposit
  • Uses apiUrl(api.cointr.com) as the Base Endpoint.

  • Uses /api/v2/spot/account/bills as the Endpoint.

  • Uses api/v1/coin-tr/deposit-withdraw-history as the RCXT Endpoint.

  • apiKey, secretKey, and password values are taken from the header.

  • From query parameters, startTime, fromId, orderId, and type values are taken:

    • startTime: The date from which we want to fetch the data.
    • fromId: Enter the ID if fetching a specific trade.
    • orderId: Used to filter by a specific order ID.
    • type: Available values are deposit, withdrawal, transferIn, and transferOut. Use deposit for Deposit.
  • Limiter:

    • Each API endpoint has a specific Request Weight value assigned. The Request Weight value for Deposit is 10.
    • A maximum of 100 records can be fetched per page.
Withdrawal
  • Uses apiUrl(api.cointr.com) as the Base Endpoint.

  • Uses /api/v2/spot/wallet/withdrawal-records as the Endpoint.

  • Uses api/v1/coin-tr/deposit-withdraw-history as the RCXT Endpoint.

  • apiKey, secretKey, and password values are taken from the header.

  • From query parameters, startTime, fromId, orderId, and type values are taken:

    • startTime: The date from which we want to fetch the data.
    • fromId: Enter the ID if fetching a specific trade.
    • orderId: Used to filter by a specific order ID.
    • type: Available values are deposit, withdrawal, transferIn, and transferOut. Use withdrawal for Withdrawal.
  • Limiter:

    • Each API endpoint has a specific Request Weight value assigned. The Request Weight value for Withdrawal is 10.
    • A maximum of 100 records can be fetched per page.
Transfer In
  • Uses apiUrl(api.cointr.com) as the Base Endpoint.

  • Uses /api/v2/spot/account/bills as the Endpoint.

  • Uses api/v1/coin-tr/deposit-withdraw-history as the RCXT Endpoint.

  • apiKey, secretKey, and password values are taken from the header.

  • From query parameters, startTime, fromId, orderId, and type values are taken:

    • startTime: The date from which we want to fetch the data.
    • fromId: Enter the ID if fetching a specific trade.
    • orderId: Used to filter by a specific order ID.
    • type: Available values are deposit, withdrawal, transferIn, and transferOut. Use transferIn for Transfer In.
  • Limiter:

    • Each API endpoint has a specific Request Weight value assigned. The Request Weight value for Transfer In is 10.
    • A maximum of 500 records can be fetched per page.
Transfer Out
  • Uses apiUrl(api.cointr.com) as the Base Endpoint.

  • Uses /api/v2/spot/wallet/withdrawal-records as the Endpoint.

  • Uses api/v1/coin-tr/deposit-withdraw-history as the RCXT Endpoint.

  • apiKey, secretKey, and password values are taken from the header.

  • From query parameters, startTime, fromId, orderId, and type values are taken:

    • startTime: The date from which we want to fetch the data.
    • fromId: Enter the ID if fetching a specific trade.
    • orderId: Used to filter by a specific order ID.
    • type: Available values are deposit, withdrawal, transferIn, and transferOut. Use transferOut for Transfer Out.
  • Limiter:

    • Each API endpoint has a specific Request Weight value assigned. The Request Weight value for Transfer Out is 10.
    • A maximum of 100 records can be fetched per page.

Response Example:

{
  "depositWithdrawals": [
    {
      "fiatCurrency": "",
      "cryptoCurrency": "ACA",
      "fiatAmount": "",
      "cryptoAmount": "199.9",
      "price": "",
      "address": "21Pau9weZ19NtbojGKnjFUDd2RZ4mpMMFqfYeYHmHLxV9ncr",
      "orderId": "",
      "transactionId": "4355261931473846528",
      "fee": "",
      "network": "ACA",
      "status": "1",
      "time": 1737552240000
    }
  ],
  "cursor": ""
}

Fetch Ticker

Ticker
  • Uses apiUrl(api.cointr.com) as the Base Endpoint.

  • Uses /api/v2/spot/market/tickers as the Endpoint.

  • Uses api/v1/coin-tr/ticker as the RCXT Endpoint.

  • Only the symbol query parameter is taken (e.g. BTCUSDT):

    • symbol: Specifies the trading pair symbol.
  • Limiter:

    • Each API endpoint has a specific Request Weight value assigned. The Request Weight value for Ticker is 20.

Response Example:

{
  "symbol": "BTCUSDT",
  "price": "104562.53000000"
}