Error Codes

Reference for ByteConnect API error codes and how to resolve them.

Error Response Format

All errors return a consistent JSON structure:

{
  "success": false,
  "error": {
    "code": "INVALID_TOKEN",
    "message": "The access token is invalid or expired"
  }
}

Authentication Errors

Code	Message	Resolution
INVALID_CREDENTIALS	Username or password is incorrect	Verify your login credentials
INVALID_TOKEN	Access token is invalid or expired	Re-authenticate to get a new token
TOKEN_EXPIRED	Access token has expired	Tokens expire after 1 hour; re-authenticate
MISSING_TOKEN	No access token provided	Include access_token in request body

Transaction Errors

Code	Message	Resolution
INVALID_AMOUNT	Amount must be a positive number	Ensure amount is greater than 0
AMOUNT_TOO_LOW	Amount below minimum threshold	Check minimum transaction amount
AMOUNT_TOO_HIGH	Amount exceeds maximum limit	Reduce transaction amount
INVALID_CRYPTO	Unsupported cryptocurrency	Use a supported crypto code (BTC, LTC, ETH, etc.)
TRANSACTION_NOT_FOUND	Transaction ID not found	Verify the transaction ID
TRANSACTION_EXPIRED	Transaction has timed out	Create a new transaction

Payout Errors

Code	Message	Resolution
INSUFFICIENT_BALANCE	Not enough funds for payout	Wait for more payments or reduce payout amount
BELOW_MINIMUM	Amount below payout minimum	Check minimum payout amounts
INVALID_ADDRESS	Invalid wallet address	Verify the destination address
PAYOUT_DISABLED	Payouts temporarily disabled	Contact support

Rate Limit Errors

Code	Message	Resolution
RATE_LIMITED	Too many requests	Wait and retry with exponential backoff

Validation Errors

Code	Message	Resolution
INVALID_EMAIL	Email format is invalid	Provide a valid email address
MISSING_FIELD	Required field is missing	Check required parameters
INVALID_FORMAT	Request format is invalid	Ensure valid JSON in request body

HTTP Status Codes

Status	Meaning
200	Success
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid or missing token
403	Forbidden - Access denied
404	Not Found - Resource doesn’t exist
429	Too Many Requests - Rate limited
500	Server Error - Contact support

Handling Errors

Example Error Handling

async function createTransaction(data) {
  const response = await fetch('https://quinix.byteconnect.us/create_transaction', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(data)
  });

  const result = await response.json();

  if (!result.success) {
    switch (result.error.code) {
      case 'TOKEN_EXPIRED':
        // Re-authenticate and retry
        await refreshToken();
        return createTransaction(data);
      case 'RATE_LIMITED':
        // Wait and retry
        await sleep(5000);
        return createTransaction(data);
      default:
        throw new Error(result.error.message);
    }
  }

  return result;
}

Getting Help

If you encounter persistent errors:

1. Check the API documentation
2. Verify your request format
3. Contact support with the error code and transaction details