Place Order

Testnet Env

https://testnet.trade.vessel.finance

POST

/api/v1/order

Last modified:2024-10-15 06:23:56

Place Order allows users to place a specific order on our platform. To utilize this API, follow the Poseidon Signature Guide to generate the necessary body parameters and timestamp for the header. Input the generated values and proceed to test our Place Order API.

Note: Please ensure that you have followed the Poseidon Signature Guide accurately to create a valid signature. The timestamp in the header must not be earlier than the order placement request timestamp by more than 60 seconds.

Request

Header Params

Body Params application/json

Example

{
    "symbol": "WBTCUSDT",
    "side": "BUY",
    "type": "LIMIT",
    "timeInForce": "GTC",
    "quantity": "0.12",
    "price": "36000",
    "clientOrderId": "1701772026638",
    "signature": "0xd448022ed479ff946790d172ad21b4e42ad3647ac0c2a73151ffa45242bc9a093462368dafd45725d75f530c519201110f87a074167a5eb7c773d3fa99d3f66c",
    "newOrderRespType": "FULL"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://testnet.trade.vessel.finance/api/v1/order' \
--header 'VESSEL-TIMESTAMP: 1701772026638' \
--header 'VESSEL-TIMESTAMP;' \
--header 'VESSEL-API-KEY;' \
--header 'VESSEL-PASSPHRASE;' \
--header 'VESSEL-SIGNATURE;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "symbol": "WBTCUSDT",
    "side": "BUY",
    "type": "LIMIT",
    "timeInForce": "GTC",
    "quantity": "0.12",
    "price": "36000",
    "clientOrderId": "1701772026638",
    "signature": "0xd448022ed479ff946790d172ad21b4e42ad3647ac0c2a73151ffa45242bc9a093462368dafd45725d75f530c519201110f87a074167a5eb7c773d3fa99d3f66c",
    "newOrderRespType": "FULL"
}'

Responses

🟢200OK

application/json

Body

Examples

Success-FULL ResponseSuccess-ACK ResponseSuccess-RESULT Response

{
    "orderId": "3907830740629590000",
    "symbol": "BTCUSDT",
    "transactTime": "1692865580026",
    "workingTime": "1692865580029",
    "origQty": "0.001",
    "type": "MARKET",
    "side": "SELL",
    "executedQty": "0.0001",
    "status": "PARTIALLY_FILLED",
    "fills": [
        {
            "action": "REJECT",
            "price": "0",
            "qty": "0.0009"
        },
        {
            "action": "TRADE",
            "price": "1000",
            "qty": "0.0001"
        }
    ]
}

Modified at 2024-10-15 06:23:56

Internal Transfer History

Cancel Order