Crypto Traders API

Comprehensive cryptocurrency trading platform API with real-time data and seamless integration

12 Endpoints

4 Categories

99.9% Uptime

24/7 Support

GET

Crypto List

Retrieve a list of available cryptocurrencies with pagination support and filtering options.

Run in Postman

cURL

curl --location -g 'https://api.singhaitraders.in/v1/crypto?availability=buy' \
--header 'x-api-key: ak-qd8isAfyoiwON7LP7wSRTaTHEMIslLQx'

Response

{
    "responseCode": 200,
    "data": {
        "success": true,
        "message": "Cryptocurrencies fetched successfully.",
        "cryptocurrencies": [
            {
                "id": 1,
                "name": "Bitcoin",
                "symbol": "BTC",
                "logo": "crypto-logos/OD7bzqD8Zuljc8id0tXWWR0AISfMqLmnYCw1mNlP.jpg",
                "price": {
                    "buy_price": "10,252,645.90",
                    "sell_price": "10,203,066.20",
                    "previous_buy_price": "10,222,645.90",
                    "previous_sell_price": "10,200,066.20"
                }
            }
        ]
    }
}

Query Parameters

Parameter	Type	Description
`availability`	string	Filter by availability (e.g. "buy")

Headers

Header	Type	Description
`x-api-key`	string	API key for authentication

GET

Crypto Details

Get detailed information about a specific cryptocurrency including current prices and historical data.

Run in Postman

cURL

curl --location -g 'https://api.singhaitraders.in/v1/crypto/BTC' \
--header 'x-api-key: ak-qd8isAfyoiwON7LP7wSRTaTHEMIslLQx'

Response

{
    "responseCode": 200,
    "data": {
        "id": 1,
        "name": "Bitcoin",
        "symbol": "BTC",
        "logo": "crypto-logos/OD7bzqD8Zuljc8id0tXWWR0AISfMqLmnYCw1mNlP.jpg",
        "price": {
            "buy_price": "10,222,645.90",
            "sell_price": "10,200,066.20",
            "previous_buy_price": "10,222,644.80",
            "previous_sell_price": "10,200,065.12"
        }
    }
}

Headers

Header	Type	Description
`x-api-key`	string	API key for authentication

GET

Crypto Price History

Retrieve historical price data for a specific cryptocurrency with pagination and filtering options.

Run in Postman

cURL

curl --location -g 'https://api.singhaitraders.in/v1/crypto/BTC/price-history' \
--header 'x-api-key: ak-2q3BV0lEMfcUz9wdvmQWteEVxDiPE54P'

Response

{
    "responseCode": 200,
    "data": {
        "success": true,
        "message": "Crypto price history fetched successfully.",
        "crypto_price_history": [
            {
                "id": 29,
                "crypto_id": 2,
                "price": "408000.12000000",
                "price_change": "6000.00000000",
                "price_change_percentage": null,
                "updated_at": "2025-07-25T15:10:00+05:30"
            }
        ]
    }
}

GET

Orders List

Retrieve a paginated list of orders with optional filtering by status and other parameters.

Run in Postman

cURL

curl --location -g 'https://api.singhaitraders.in/v1/orders?status=pending' \
--header 'x-api-key: ak-2q3BV0lEMfcUz9wdvmQWteEVxDiPE54P'

Response

{
    "responseCode": 200,
    "data": {
        "success": true,
        "message": "Orders fetched successfully.",
        "orders": [
            {
                "id": 1,
                "order_hash_id": "ORD-6878F9A99CD78",
                "type": "swap",
                "quantity": 6,
                "price_per_unit": "2000.00000000",
                "total_amount": "0.00",
                "status": "pending",
                "payment_method": "manual",
                "crypto": {
                    "id": 1,
                    "name": "Bitcoin",
                    "symbol": "BTC"
                },
                "user": {
                    "id": 1,
                    "name": "trial",
                    "email": "trial@gmail.com"
                }
            }
        ]
    }
}

Query Parameters

Parameter	Type	Description
`status`	string	Filter by order status (pending, completed, cancelled)

GET

Order Details

Get comprehensive details about a specific order including all related information.

Run in Postman

cURL

curl --location -g 'https://api.singhaitraders.in/v1/order/ORD-6889D67C71D38' \
--header 'x-api-key: ak-2q3BV0lEMfcUz9wdvmQWteEVxDiPE54P'

Response

{
    "responseCode": 200,
    "data": {
        "id": 134,
        "order_hash_id": "ORD-6889D67C71D38",
        "type": "swap",
        "quantity": 1,
        "price_per_unit": "30000.00000000",
        "total_amount": "0.00",
        "status": "completed",
        "payment_method": "manual",
        "crypto": {
            "id": 1,
            "name": "Bitcoin",
            "symbol": "BTC"
        },
        "user": {
            "id": 1,
            "name": "trial",
            "email": "trial@gmail.com"
        }
    }
}

POST

Create Order

Create a new cryptocurrency order with specified parameters including type, quantity, and price.

Run in Postman

cURL

curl --location 'https://api.singhaitraders.in/v1/orders/create' \
--header 'x-api-key: ak-2q3BV0lEMfcUz9wdvmQWteEVxDiPE54P' \
--header 'Content-Type: application/json' \
--data '{
    "crypto_id": 1,
    "type": "sell",
    "quantity": 0.5,
    "price_per_unit": 30000.00,
    "total_price": 31500
}'

Response

{
    "responseCode": 201,
    "data": {
        "id": 149,
        "order_hash_id": "ORD-6899A7EC07B6B",
        "type": "sell",
        "quantity": 0.5,
        "price_per_unit": 30000,
        "total_amount": 31500,
        "status": "pending",
        "crypto": {
            "id": 1,
            "name": "Bitcoin",
            "symbol": "BTC"
        },
        "user": {
            "id": 1,
            "name": "trial",
            "email": "trial@gmail.com"
        }
    }
}

Request Body

Field	Type	Required	Description
`crypto_id`	integer	Yes	ID of the cryptocurrency
`type`	string	Yes	Order type (buy/sell/swap)
`quantity`	number	Yes	Amount of cryptocurrency
`price_per_unit`	number	Yes	Price per unit of cryptocurrency
`total_price`	number	Yes	Total price for the order

GET

Order Activities

Retrieve activity history and status changes for a specific order.

Run in Postman

cURL

curl --location -g 'https://api.singhaitraders.in/v1/orders/ORD-6889D67C71D38/activities' \
--header 'x-api-key: ak-2q3BV0lEMfcUz9wdvmQWteEVxDiPE54P'

PUT

Update Order Status

Update the status of an existing order to reflect current processing stage.

Run in Postman

cURL

curl --location --request PUT 'https://api.singhaitraders.in/v1/orders/ORD-6889D67C71D38/status' \
--header 'x-api-key: ak-2q3BV0lEMfcUz9wdvmQWteEVxDiPE54P' \
--header 'Content-Type: application/json' \
--data '{
    "status": "completed"
}'

Response

{
    "responseCode": 200,
    "data": {
        "message": "Order status updated successfully.",
        "order": {
            "id": 134,
            "order_hash_id": "ORD-6889D67C71D38",
            "status": "completed"
        }
    }
}

Request Body

Field	Type	Required	Description
`status`	string	Yes	New status (pending, processing, completed, cancelled)

GET

Chat Messages

Retrieve chat messages associated with a specific order for customer support.

Run in Postman

cURL

curl --location -g 'https://api.singhaitraders.in/v1/order/ORD-688E1DC4DED18/chats' \
--header 'x-api-key: ak-qd8isAfyoiwON7LP7wSRTaTHEMIslLQx'

Response

{
    "responseCode": 200,
    "data": {
        "success": true,
        "message": "Chats fetched successfully.",
        "chats": [
            {
                "id": 313,
                "sender_id": 1,
                "receiver_id": null,
                "order_id": 169,
                "message": "Hello, when will my order be processed?",
                "attachment_url": null,
                "is_read": 1,
                "created_at": "2025-08-02T19:46:36+05:30"
            }
        ]
    }
}

POST

Send Chat Message

Send a new chat message for customer support on a specific order.

Run in Postman

cURL

curl --location 'https://api.singhaitraders.in/v1/order/order_id/chat' \
--header 'x-api-key: ak-XHWXtiqP6jEg7kVOqCtDTOaQGwNNDrB2' \
--header 'Content-Type: application/json' \
--data '{
    "sender_id": 1,
    "receiver_id": 2,
    "message": "Hello, when will my order be processed?"
}'

Response

{
    "responseCode": 200,
    "data": {
        "id": 206,
        "sender_id": "1",
        "receiver_id": "2",
        "order_id": 121,
        "message": "Hello, when will my order be processed?",
        "attachment_url": null,
        "is_read": false,
        "created_at": "2025-08-11T13:55:10+05:30"
    }
}

Request Body

Field	Type	Required	Description
`sender_id`	integer	Yes	ID of the message sender
`receiver_id`	integer	No	ID of the message receiver
`message`	string	Yes	The chat message content

POST

Mark Messages as Read

Mark all chat messages as read for a specific order to update message status.

Run in Postman

cURL

curl --location 'https://api.singhaitraders.in/v1/order/ORD-68839D08E6812/chat/mark-as-read-messages' \
--header 'x-api-key: ak-XHWXtiqP6jEg7kVOqCtDTOaQGwNNDrB2'

Response

{
    "responseCode": 200,
    "data": {
        "message": "Chat messages marked as read successfully."
    }
}

Error Codes

The Singhai Traders API uses conventional HTTP response codes to indicate the success or failure of an API request.

Code	Status	Description
`200`	OK	The request was successful
`201`	Created	The resource was successfully created
`400`	Bad Request	The request was malformed or missing required parameters
`401`	Unauthorized	The API key provided was invalid or missing
`403`	Forbidden	The API key doesn't have permission to perform this request
`404`	Not Found	The requested resource was not found
`429`	Too Many Requests	You have exceeded the rate limit
`500`	Internal Server Error	An unexpected error occurred on the server

Error Response Example

{
    "responseCode": 400,
    "error": {
        "code": "INVALID_REQUEST",
        "message": "The request is missing required parameters",
        "details": {
            "missing_fields": ["crypto_id", "quantity"]
        }
    }
}