Skip to main content
POST
/
api
/
public
/
v1
/
trades
curl --request POST \
  --url https://api.wallbit.io/api/public/v1/trades \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "symbol": "AAPL",
  "direction": "BUY",
  "currency": "USD",
  "order_type": "MARKET",
  "amount": 100
}
'
{
  "data": {
    "symbol": "AAPL",
    "direction": "BUY",
    "amount": 100,
    "shares": 0.5847953,
    "status": "REQUESTED",
    "order_type": "MARKET",
    "created_at": "2024-01-15T10:30:00.000000Z",
    "updated_at": "2024-01-15T10:30:00.000000Z"
  }
}

Authorizations

​
X-API-Key
string
header
required

API Key authentication. Obtain your API key from the Wallbit dashboard under Settings → API Keys.

Body

application/json
​
symbol
string
required

Asset symbol (e.g., AAPL, TSLA, MSFT)

Example:

"AAPL"

​
direction
enum<string>
required

Trade direction

Available options:
BUY,
SELL
Example:

"BUY"

​
currency
string
required

Currency (only USD supported)

Example:

"USD"

​
order_type
enum<string>
required

Order type

Available options:
MARKET,
LIMIT,
STOP,
STOP_LIMIT
Example:

"MARKET"

​
amount
number<float>

Amount in USD (required if shares not specified)

Example:

100

​
shares
number<float>

Number of shares (required if amount not specified)

Example:

5

​
stop_price
number<float>

Stop price (required for STOP and STOP_LIMIT)

Example:

150

​
limit_price
number<float>

Limit price (required for LIMIT and STOP_LIMIT)

Example:

145.5

​
time_in_force
enum<string>

Time in force (required for LIMIT)

Available options:
DAY,
GTC
Example:

"DAY"

Response

Trade created successfully

​
data
object