Login
- Body encoding
LG(See BTP Body Encoding).
Login Request
The Bitnomial trading system requires a Connection to be provisioned
in order to login. To provision a connection, visit the
customer portal. ConnectionIDs are provided in a hex-encoded
byte string that must be converted into a single uint64. AuthTokens are provided as hex-encoded
byte strings.
A connection can simultaneously connect to a single order entry gateway and pricefeed instance but cannot connect to another order entry gateway or pricefeed at the same time.
| Byte Offset | Byte Length | Type | Name | Description |
|---|---|---|---|---|
| 0 | 1 | char | messageType | Always L |
| 1 | 8 | uint64 | connectionId | Connection ID |
| 9 | 32 | byte[] | authToken | Shared secret |
| 41 | 1 | uint8 | heartbeatInterval | Heartbeat interval in seconds |
| 42 |
Login Heartbeat Interval
If the heartbeat interval is less than or equal to 5 seconds, a default value of 30 seconds will be used instead.
Logout Request
| Byte Offset | Byte Length | Type | Name | Description |
|---|---|---|---|---|
| 0 | 1 | char | messageType | Always K |
| 1 | 1 | char | persistOrders | Cancel-on-disconnect is default (unused, reserved) |
| 2 |
Login/out Reply
Login/out Ack
| Byte Offset | Byte Length | Type | Name | Description |
|---|---|---|---|---|
| 0 | 1 | char | messageType | Always A |
| 1 |
Login/out Reject
| Byte Offset | Byte Length | Type | Name | Description |
|---|---|---|---|---|
| 0 | 1 | char | messageType | Always R |
| 1 | 1 | uint8 | rejectReason | See Login/out Reject Reason |
| 2 |
Login/out Reject Reason
| Value | Reason |
|---|---|
0x01 | No request received, didn't receive a login within 1 s |
0x02 | Unauthorized |
0x03 | Already logged in |
0x04 | Bad protocol version |
Start Trading
Trade US Perpetual Futures, Physical Futures, and Options on the Bitcoin Complex®, XRP, ETH, SOL, and more.
Signing up with Bitnomial, Inc. requires additional verification with an FCM to trade futures. Futures accounts are offered by Bitnomial Clearing, LLC, a CFTC-registered FCM and NFA member. Trading in futures involves substantial risks. You should only trade in financial products that you are familiar with and understand the associated risks, and after carefully considering whether such trading is suitable in light of your investment experience, financial position, and investment objectives. Leverage in futures trading can work for you or against you. The risk of loss using leverage can exceed your initial investment amount. See Bitnomial entity affiliation and registration disclosures and FCM financial and risk disclosures.