/// <summary>
/// Start a new user data stream.
/// </summary>
/// <param name="client"></param>
/// <param name="apiKey"></param>
/// <param name="token"></param>
/// <returns></returns>
public static Task <string> UserStreamStartAsync(this IBinanceHttpClient client, string apiKey, CancellationToken token = default)
{
Throw.IfNullOrWhiteSpace(apiKey, nameof(apiKey));
var request = new BinanceHttpRequest("/api/v1/userDataStream")
{
ApiKey = apiKey
};
return(client.PostAsync(request, token));
}
/// <summary>
/// Submit a withdraw request.
/// </summary>
/// <param name="client"></param>
/// <param name="user"></param>
/// <param name="asset"></param>
/// <param name="address"></param>
/// <param name="addressTag"></param>
/// <param name="amount"></param>
/// <param name="name">A description of the address (optional).</param>
/// <param name="recvWindow"></param>
/// <param name="token"></param>
/// <returns></returns>
public static async Task <string> WithdrawAsync(this IBinanceHttpClient client, IBinanceApiUser user, string asset, string address, string addressTag, decimal amount, string name = null, long recvWindow = default, CancellationToken token = default)
{
Throw.IfNull(client, nameof(client));
Throw.IfNull(user, nameof(user));
Throw.IfNullOrWhiteSpace(asset, nameof(asset));
Throw.IfNullOrWhiteSpace(address, nameof(address));
if (amount <= 0)
{
throw new ArgumentException("Withdraw amount must be greater than 0.", nameof(amount));
}
if (recvWindow == default)
{
recvWindow = client.DefaultRecvWindow;
}
if (client.RateLimiter != null)
{
await client.RateLimiter.DelayAsync(token : token)
.ConfigureAwait(false);
}
var request = new BinanceHttpRequest("/wapi/v3/withdraw.html")
{
ApiKey = user.ApiKey
};
request.AddParameter("asset", asset.FormatSymbol());
request.AddParameter("address", address);
request.AddParameter("amount", amount);
if (!string.IsNullOrWhiteSpace(addressTag))
{
request.AddParameter("addressTag", addressTag);
}
if (!string.IsNullOrWhiteSpace(name))
{
request.AddParameter("name", name);
}
if (recvWindow > 0)
{
request.AddParameter("recvWindow", recvWindow);
}
await client.SignAsync(request, user, token)
.ConfigureAwait(false);
return(await client.PostAsync(request, token)
.ConfigureAwait(false));
}
/// <summary>
/// Start a new user data stream.
/// </summary>
/// <param name="client"></param>
/// <param name="apiKey"></param>
/// <param name="token"></param>
/// <returns></returns>
public static async Task <string> UserStreamStartAsync(this IBinanceHttpClient client, string apiKey, CancellationToken token = default)
{
Throw.IfNullOrWhiteSpace(apiKey, nameof(apiKey));
if (client.RateLimiter != null)
{
await client.RateLimiter.DelayAsync(token : token)
.ConfigureAwait(false);
}
var request = new BinanceHttpRequest("/api/v1/userDataStream")
{
ApiKey = apiKey
};
return(await client.PostAsync(request, token)
.ConfigureAwait(false));
}
/// <summary>
/// Send in a new order.
/// </summary>
/// <param name="client"></param>
/// <param name="user"></param>
/// <param name="symbol"></param>
/// <param name="side"></param>
/// <param name="type"></param>
/// <param name="quantity"></param>
/// <param name="price"></param>
/// <param name="newClientOrderId">A unique id for the order. Automatically generated if not sent.</param>
/// <param name="timeInForce"></param>
/// <param name="stopPrice">Used with STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, and TAKE_PROFIT_LIMIT orders.</param>
/// <param name="icebergQty">Used with iceberg orders.</param>
/// <param name="recvWindow"></param>
/// <param name="isTestOnly">If true, test new order creation and signature/recvWindow; creates and validates a new order but does not send it into the matching engine.</param>
/// <param name="newOrderRespType">Set the response JSON.</param>
/// <param name="token"></param>
/// <returns></returns>
public static async Task <string> PlaceOrderAsync(this IBinanceHttpClient client, IBinanceApiUser user, string symbol, OrderSide side, OrderType type, decimal quantity, decimal price, string newClientOrderId = null, TimeInForce?timeInForce = null, decimal stopPrice = 0, decimal icebergQty = 0, long recvWindow = default, bool isTestOnly = false, PlaceOrderResponseType newOrderRespType = PlaceOrderResponseType.Result, CancellationToken token = default)
{
Throw.IfNull(client, nameof(client));
Throw.IfNull(user, nameof(user));
Throw.IfNullOrWhiteSpace(symbol, nameof(symbol));
if (quantity <= 0)
{
throw new ArgumentException("Order quantity must be greater than 0.", nameof(quantity));
}
if (recvWindow <= 0)
{
recvWindow = client.Options.RecvWindowDefault ?? 0;
}
var request = new BinanceHttpRequest($"/api/v3/order{(isTestOnly ? "/test" : string.Empty)}")
{
ApiKey = user.ApiKey
};
request.AddParameter("symbol", symbol.FormatSymbol());
request.AddParameter("side", side.ToString().ToUpperInvariant());
request.AddParameter("type", type.AsString());
request.AddParameter("newOrderRespType", newOrderRespType.ToString().ToUpperInvariant());
request.AddParameter("quantity", quantity);
if (price > 0)
{
request.AddParameter("price", price);
}
if (timeInForce.HasValue)
{
request.AddParameter("timeInForce", timeInForce.ToString().ToUpperInvariant());
}
if (!string.IsNullOrWhiteSpace(newClientOrderId))
{
request.AddParameter("newClientOrderId", newClientOrderId);
}
if (stopPrice > 0)
{
request.AddParameter("stopPrice", stopPrice);
}
if (icebergQty > 0)
{
// Automatically set time-in-force to GTC if not set.
if (!timeInForce.HasValue)
{
timeInForce = TimeInForce.GTC;
}
if (timeInForce != TimeInForce.GTC)
{
throw new BinanceApiException("Any order with an icebergQty MUST have timeInForce set to GTC.");
}
request.AddParameter("icebergQty", icebergQty);
}
if (recvWindow > 0)
{
request.AddParameter("recvWindow", recvWindow);
}
await client.SignAsync(request, user, token)
.ConfigureAwait(false);
return(await client.PostAsync(request, token, user.RateLimiter)
.ConfigureAwait(false));
}
