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/assetsas the Endpoint. - Uses
api/v1/coin-tr/balancesas the RCXT Endpoint.
The user sends a GET request to query CoinTR wallet balances.
This request must include the required header parameters:
-
apiKey,secretKey, andpasswordvalues 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/fillsas the Endpoint. -
Uses
api/v1/coin-tr/balancesas the RCXT Endpoint. -
apiKey,secretKey, andpasswordvalues are taken from the header. -
From query parameters,
startTime,symbol,fromId,orderId, andtypevalues 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-ordersas the Endpoint. -
Uses
api/v1/coin-tr/ordersas the RCXT Endpoint. -
apiKey,secretKey, andpasswordvalues are taken from the header. -
From query parameters,
startTime,endTime,symbol,fromId,singleOrderId,type, andorderStatusvalues 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: IforderStatusis “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-ordersas the Endpoint. -
Uses
api/v1/coin-tr/ordersas the RCXT Endpoint. -
apiKey,secretKey, andpasswordvalues are taken from the header. -
From query parameters,
startTime,endTime,symbol,fromId,singleOrderId,type, andorderStatusvalues 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: IforderStatusis “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/billsas the Endpoint. -
Uses
api/v1/coin-tr/deposit-withdraw-historyas the RCXT Endpoint. -
apiKey,secretKey, andpasswordvalues are taken from the header. -
From query parameters,
startTime,fromId,orderId, andtypevalues 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-recordsas the Endpoint. -
Uses
api/v1/coin-tr/deposit-withdraw-historyas the RCXT Endpoint. -
apiKey,secretKey, andpasswordvalues are taken from the header. -
From query parameters,
startTime,fromId,orderId, andtypevalues 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/billsas the Endpoint. -
Uses
api/v1/coin-tr/deposit-withdraw-historyas the RCXT Endpoint. -
apiKey,secretKey, andpasswordvalues are taken from the header. -
From query parameters,
startTime,fromId,orderId, andtypevalues 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-recordsas the Endpoint. -
Uses
api/v1/coin-tr/deposit-withdraw-historyas the RCXT Endpoint. -
apiKey,secretKey, andpasswordvalues are taken from the header. -
From query parameters,
startTime,fromId,orderId, andtypevalues 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/tickersas the Endpoint. -
Uses
api/v1/coin-tr/tickeras the RCXT Endpoint. -
Only the
symbolquery 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"
}