Introduction

Welcome to ALP.COM API v3 docs!

Service ALP.COM provides open API for trading operations and broadcasting of all trading events.

HTTP API endpoint available on https://alp.com/api/v3/.

For users currently using API v1, we strongly recommend transitioning to API v3, as API v1 will soon be deprecated and no longer available.

Available clients: - Python: https://pypi.org/project/alpcom-api/

# pip3 install alpcom-api

from alpcom_api import factories, cache

public_api = factories.get_public_api()
private_api = factories.get_private_api(
    key='** Your private_api Key **',
    secret='** Your private_api Secret **',
    # Optionally use cache to store temp token
    # otherwise it will be generated every time an instance of HTTPClient gets created
    # cache=cache.FileCache('/path/to/token.txt') 
)

Constants

Wallet Types

• SPOT: Spot Wallet
• MARGIN_CROSS: Cross Margin Wallet
• MARGIN_ISOLATED: Isolated Margin Wallet
• FUNDING: Funding Wallet

Order Sides

• BUY: Buy Order
• SELL: Sell Order

Order Types

• MARKET: Market Order
• LIMIT: Limit Order
• STOP_LIMIT: Stop-Limit Order
• STOP_MARKET: Stop-Market Order

Order Status

• UNDEFINED: Undefined Order Status
• PENDING: Pending Order
• OPEN: Open Order
• CANCELLED: Cancelled Order
• PARTIAL_CANCELLED: Partially Cancelled Order
• PARTIAL_FILLED: Partially Filled Order
• FILLED: Filled Order
• EXPIRED: Expired Order
• FAILED: Failed Order

Order Time in Force

• GOOD_TILL_CANCEL: Good 'til Cancelled
• IMMEDIATE_OR_CANCEL: Immediate or Cancel
• ALL_OR_NONE: All or None
• FILL_OR_KILL: Fill or Kill
• UNDEFINED_TIME_IN_FORCE: Undefined Time in Force

Order Side Effects

• NO_SIDE_EFFECT: No Side Effect
• AUTO_BORROW: Auto Borrow
• AUTO_REPLAY: Auto Replay

Order Stop Operators

• GTE: Greater Than or Equal To
• LTE: Less Than or Equal To

Margin Loan Types

• AUTO: Auto Loan Type
• MANUAL: Manual Loan Type

Margin Directions

• ADD: Add to Margin
• SUB: Subtract from Margin

Deposit Status

• PENDING: Pending Deposit
• MODERATION: In Moderation
• CONFIRMED: Confirmed Deposit
• REJECTED: Rejected Deposit

Withdrawal Status

• NEW: New Withdrawal
• CONFIRMED: Confirmed Withdrawal
• VERIFIED: Verified Withdrawal
• MODERATION: Withdrawal in Moderation
• APPROVED: Approved Withdrawal
• SUSPENDED: Suspended Withdrawal
• DONE: Completed Withdrawal
• REFUSED: Refused Withdrawal
• CANCELED: Cancelled Withdrawal

Chart Intervals

• FIVE_MIN: 5 minutes
• FIFTEEN_MINS: 15 minutes
• HALF_HOUR: 30 minutes
• HOUR: 1 hour
• FOUR_HOURS: 4 hours
• DAY: 1 day

Public API

Currencies

GET /api/v3/currencies

public_api.currencies()

Response

[
  {
    "sign": "Ƀ",
    "short_name": "BTC"
  }, ...
]

Pairs

GET /api/v3/pairs

Query Parameters

public_api.pairs()

Response

[{
    "name": "BTC/USDT",
    "currency1": "BTC",
    "currency2": "USDT",
    "amount_precision": 8,
    "price_precision": 2,
    "maximum_order_size": 10.0,
    "minimum_order_size": 0.001,
    "minimum_order_value": 10.0
}, ...]

Tickers

GET /api/v3/ticker

Query Parameters

public_api.ticker()

Response

[{
    "pair": "BTC/USD",
    "last": 45000.0,
    "vol": 1000.0,
    "buy": 44990.0,
    "sell": 45010.0,
    "high": 45500.0,
    "low": 44500.0,
    "diff": 10.0,
    "timestamp": 1630862400.0
}, ...]

Orderbook

GET /api/v3/orderbook

Query Parameters

public_api.orderbook('BTC_USDT')

Response

{
    "buy": [
        {
            "amount": 1.0,
            "price": 45000.0
        },
        {
            "amount": 2.0,
            "price": 44990.0
        }
    ],
    "sell": [
        {
            "amount": 1.0,
            "price": 45010.0
        },
        {
            "amount": 2.0,
            "price": 45020.0
        }
    ]
}

Charts

GET /api/v3/charts

Query Parameters

import time
from alpcom_api import dto

candle_list = public_api.charts(
    pair='BTC_USDT',
    interval=dto.ChartInterval.DAY,
    since=int(time.time()) - 60 * 60 * 24 * 10  # last 10 days
)

Response

[{
    "open": 45000.0,
    "close": 45100.0,
    "high": 45200.0,
    "low": 44900.0,
    "volume": 1000.0,
    "time": 1630862400.0
}, ...]

Trades

GET /api/v3/trades

Query Parameters

last_trades = public_api.trades(pair='BTC_USDT', limit=10)

Response

[{
    "id": 1,
    "account_id": 101,
    "pair": "BTC/USDT",
    "amount": 2.5,
    "price": 45000.0,
    "timestamp": 1630862400.0,
    "type": "buy"
}, ...]

Private API

Authorization

To access private API, clients must use JWT tokens for authentication. Tokens must be included in the Authorization header as follows: Authorization: Bearer {token}

Token Expiration

Clients should check the key exp in the JWT token payload, which contains a timestamp indicating the token's expiration time. Tokens are valid until this time.

Obtaining JWT Tokens

JWT token generates by API Key and API Secret. The API Key pair can be generated in user profile, by link https://alp.com/en/profile/api To generate it, make a POST request to the following endpoint: https://alp.com/api/v3/auth with body json { "api_key": "<Your API Key>", "api_secret": "<Your API Secret>" }

POST Method Signature (X-SIGN Header)

For POST requests, clients must include a request signature in the X-SIGN header. Calculate this signature as the HMAC SHA-256 hash of the request body using the api_secret obtained earlier.

Accounts

GET /api/v3/accounts/accounts

Query Parameters

private_api.accounts().accounts(include_subaccounts=True)

Response

[{
    "id": 123,
    "email": "example@email.com",
    "name": "John Doe",
    "parent_id": null
}]

where: parent_id - for sub accounts it indicates id of master account

Account Balances

GET /api/v3/accounts/balances

private_api.accounts().balances()

Response

[{
    "balance": 1000.0,
    "reserve": 500.0,
    "currency": "USDT",
    "wallet_type": "SPOT",
    "last_update_at": "2023-09-04T12:00:00Z",
    "account_id": 12345
}
...]

where: reserve - balance in open orders, pending withdraws, etc.

Fee Info

GET /api/v3/accounts/feeinfo

private_api.accounts().fees()

Response

[{
    "account_id": 12345,
    "active_once": ["2023-09-04T12:00:00Z", "2023-09-05T12:00:00Z"],
    "taker_fee_rate": 0.002,
    "maker_fee_rate": 0.0015,
    "fee_currency": "USD",
    "priority": 1,
    "currency": null,
    "pair": null,
    "is_active": true
}...]

Orders

GET /api/v3/accounts/order

Query Parameters

private_api.accounts().orders('ETH_USDT', open_only=True)

Response

[{
    "id": 123,
    "account_id": 456,
    "pair": "BTC/USDT",
    "amount": 1.5,
    "price": 45000.0,
    "side": "BID",
    "status": "FILLED",
    "type": "LIMIT",
    "wallet_type": "SPOT",
    "amount_canceled": 0.0,
    "amount_filled": 1.5,
    "date": "2023-09-04T12:00:00Z",
    "open_at": "2023-09-04T11:59:00Z",
    "tif": "GTC",
    "updated_at": "2023-09-04T12:01:00Z",
    "done_at": null,
    "expire_after": null,
    "stop_price": null
} ...]

Note

start_time and end_time interval must not exceed 30 days. If one is not set 30 days interval from set value is applied. If both are not set, default time interval is 30 days back from today.

Account Trades

GET /api/v3/accounts/trades

Query Parameters

private_api.accounts().trades('ETH_USDT')

Response

[{
    "account_id": 12345,
    "pair": "BTC/USD",
    "amount": 1.0,
    "amount_unfilled": 0.5,
    "price": 45000.0,
    "currency": "USD",
    "status": "FILLED",
    "date": "2023-09-04T12:00:00Z",
    "fee_amount": 0.005,
    "fee_currency": "USD",
    "fee_rate": 0.005,
    "is_maker": true,
    "type": "LIMIT",
    "wallet_type": "SPOT"
}, ...]

Note

start_time and end_time interval must not exceed 30 days. If one is not set 30 days interval from set value is applied. If both are not set, default time interval is 30 days back from today.

Operation History

GET /api/v3/accounts/activity

Query Parameters

private_api.accounts().history('USDT')

Response

[{
    "id": 1,
    "account_id": 12345,
    "wallet_id": 67890,
    "type": "DEPOSIT",
    "balance": 1000.0,
    "balance_delta": 500.0,
    "balance_end": 1500.0,
    "reserve": 100.0,
    "reserve_delta": 50.0,
    "reserve_end": 150.0,
    "currency": "USDT",
    "wallet_type": "SPOT",
    "date": "2023-09-04T12:00:00Z"
}...]

Note

start_time and end_time interval must not exceed 30 days. If one is not set 30 days interval from set value is applied. If both are not set, default time interval is 30 days back from today.

Deposit Methods

GET /api/v3/deposit/methods

Query Parameters

private_api.deposits().methods(currency='USDT')

Response

[{
    "network": "Example Network",
    "currency": "USDT",
    "attributes": [
        {
            "key": "address",
            "value": "0x1234567890abcdef"
        },
        {
            "key": "memo",
            "value": "123456"
        }
    ],
    "confirmations": 6,
    "min_deposit": 10.0,
    "max_deposit": 1000.0,
    "is_enabled": true
}, ...]

Deposit History

GET /api/v3/deposit

Query Parameters

private_api.deposits().history(currency='USDT')

Response

[{
    "id": 123,
    "amount": 100.0,
    "currency": "BTC",
    "status": "PENDING",
    "tx_hash": "0xabc123def456",
    "date": "2023-09-04T12:00:00Z"
}, ...]

Withdraw Methods

GET /api/v3/withdraw/methods

Query Parameters

private_api.withdraws().methods(currency='USDT')

Response

[{
    "id": 123,
    "network": "ETH",
    "currency": "USD",
    "attributes": [
        {
            "key": "address",
            "value": "0x1234567890abcdef"
        },
        {
            "key": "memo",
            "value": "123456"
        }
    ],
    "fee_rate": 0.002,
    "fee_amount": 5.0,
    "fee_currency": "USD",
    "min_withdraw": 10.0,
    "max_withdraw": 1000.0,
    "is_enabled": true
}
, ...]

Note

This method is disabled by default, set "Can Withdraw" during creation of an API-Key to use it.

Withdraw Request

POST /api/v3/withdraw

Body Parameters

from alpcom_api import dto

req = dto.WithdrawRequest(
    amount=10.0,
    method=2,
    attributes={
        'address': '<my_dest_addr>',
        'memo': '<extra memo>'
    },
    client_order_id='order_123'
)
private_api.withdraws().create(req)

Query Body

{
    "amount": 50.0,
    "method": 123,
    "attributes": {
        "address": "0xabcdef1234567890",
        "memo": "123456"
    },
    "client_order_id": "withdraw-1"
}

Note

This method is disabled by default, set "Can Withdraw" during creation of an API-Key to use it.

Withdraw History

GET /api/v3/withdraw

Query Parameters

private_api.withdraws().history(currency='USDT')

Response

[{
    "id": 123,
    "amount": 50.0,
    "fee_amount": 2.0,
    "currency": "BTC",
    "fee_currency": "BTC",
    "status": "COMPLETED",
    "tx_hash": "0xabcdef1234567890",
    "date": "2023-09-04T12:00:00Z"
}
, ...]

Note

This method is disabled by default, set "Can Withdraw" during creation of an API-Key to use it.

Place Order

POST /api/v3/trading/order

Body Parameters

Limit Order Request

{
    "pair": "BTC/USD",
    "order_side": "BID",
    "client_order_id": "1",
    "wallet_type": "SPOT",
    "side_effect": "NO_SIDE_EFFECT",
    "valid_till": null,
    "expire_after": null,
    "base_amount": 1.0,
    "limit_price": 45000.0,
    "order_type": "LIMIT",
    "tif": "GTC"
}

from alpcom_api import dto

req_limit = dto.LimitOrderRequest(
    pair='ETH_USDT',
    order_side=dto.OrderSide.SELL,
    base_amount=0.05,
    limit_price=1800,
)

private_api.trading().place_order(req_limit)

Market Order Request

{
    "pair": "BTC/USD",
    "order_side": "BID",
    "client_order_id": "1",
    "wallet_type": "SPOT",
    "side_effect": "NO_SIDE_EFFECT",
    "valid_till": null,
    "expire_after": null,
    "base_amount": null,
    "quote_amount": null,
    "order_type": "MARKET"
}

from alpcom_api import dto

req_market = dto.MarketOrderRequest(
    pair='ETH_USDT',
    order_side=dto.OrderSide.SELL,
    base_amount=0.1 # base_amount or quote_amount
)

private_api.trading().place_order(req_market)

Stop Limit Order Request

{
    "pair": "BTC/USD",
    "order_side": "BID",
    "client_order_id": "1",
    "wallet_type": "SPOT",
    "side_effect": "NO_SIDE_EFFECT",
    "valid_till": null,
    "expire_after": null,
    "base_amount": 1.0,
    "limit_price": 45000.0,
    "stop_price": 44000.0,
    "stop_operator": "GTE",
    "order_type": "STOP_LIMIT",
    "tif": "GTC"
}

from alpcom_api import dto

req_stop_limit = dto.StopLimitOrderRequest(
    pair='ETH_USDT',
    order_side=dto.OrderSide.SELL,
    stop_price=1800,
    stop_operator=dto.StopOperator.GTE,
    base_amount=0.05,
    limit_price=1700,
)

private_api.trading().place_order(req_stop_limit)

Response, (Array of created order ids)

[34]

Cancel Order

DELETE /api/v3/trading/order

Body Parameters

Query Body

{
  "order_ids": [1, 5, 8],
  "all": false,
  "pair": ""
}

private_api.trading().cancel_order(12312332)
private_api.trading().cancel_orders([12312332, 12312334, 12312338])
private_api.trading().cancel_orders_of_pair('ETH_USDT')

Margin Transfer

POST /api/v3/margin/transfer

Body Parameters

from alpcom_api import dto

req = dto.MarginTransferRequest(
    account_id=384457,
    wallet_type=dto.WalletType.MARGIN_CROSS,
    direction=dto.MarginDirection.ADD,
    amount=1,
    currency='ETH',
)

operation_id = private_api.margin().transfer(req)

Query Body

{
    "account_id": 12345,
    "wallet_type": "SPOT",
    "direction": "ADD",
    "amount": 100.0,
    "currency": "USDT",
    "pair": null,
    "note": null
}

Response:

123 # transfer id

Note

This method is disabled by default, set "Margin" flag during creation of an API-Key to use it.

Margin Borrow

POST /api/v3/margin/borrow

Body Parameters

from alpcom_api import dto

req = dto.BorrowRequest(
    account_id=384457,
    borrow=1,
    currency='ETH',
    wallet_type=dto.WalletType.MARGIN_CROSS,
)

operation_id = private_api.margin().borrow(req)

Query Body

{
    "account_id": 12345,
    "borrow": 100.0,
    "currency": "USD",
    "wallet_type": "SPOT",
    "pair": null,
    "type": "LOAN_MANUAL"
}

Response: text 123 # borrow id

Note

This method is disabled by default, set "Margin" flag during creation of an API-Key to use it.

Margin Repay

POST /api/v3/margin/repay

Body Parameters

from alpcom_api import dto

req = dto.RepayRequest(
    account_id=384457,
    amount=0.03,
    currency='ETH',
    wallet_type=dto.WalletType.MARGIN_CROSS,
)

operation_id = private_api.margin().repay(req)

Query Body

{
    "account_id": 12345,
    "amount": 100.0,
    "currency": "USD",
    "wallet_type": "SPOT",
    "pair": null,
    "type": "LOAN_MANUAL"
}

Response: text 123 # repay id

Note

This method is disabled by default, set "Margin" flag during creation of an API-Key to use it.

Close Position

Body Parameters

DELETE /api/v3/margin

private_api.margin().close_position(account_id=384457, wallet_type=dto.WalletType.MARGIN_CROSS)

Query Body

{
  "pair": "BTC_USDT",
  "wallet_type": "ISOLATED_MARGIN"
}

Note

rather ISOLATED_MARGIN or CROSS_MARGIN must be set to wallet_type This method is disabled by default, set "Margin" flag during creation of an API-Key to use it.

Margin Loans

GET /api/v3/margin

Query Parameters

loans = private_api.margin().loans(cross_margin=True)

Response

[{
    "id": 123,
    "account_id": 456,
    "borrowed": 1000.0,
    "interest": 50.0,
    "currency": "USD",
    "wallet_type": "SPOT"
}, ...]

Note

rather isolated_margin or cross_margin must be set true This method is disabled by default, set "Margin" flag during creation of an API-Key to use it.

Margin Transfer History

GET /api/v3/margin/transfer

Query Parameters

private_api.margin().transfers('ETH', start_time=None, end_time=None)

Response

[{
    "id": 123,
    "account_id": 456,
    "amount": 100.0,
    "currency": "USD",
    "date": "2023-09-04T12:00:00Z",
    "direction": "ADD",
    "wallet_type": "SPOT",
    "note": "Transfer from Spot to Margin",
    "pair": "BTC/USD"
}, ...]

Note

start_time and end_time interval must not exceed 30 days. If one is not set 30 days interval from set value is applied. If both are not set, default time interval is 30 days back from today. This method is disabled by default, set "Margin" flag during creation of an API-Key to use it.

Margin Borrow History

GET /api/v3/margin/borrow

Query Parameters

private_api.margin().borrows('ETH', start_time=None, end_time=None)

Response

[{
    "id": 123,
    "account_id": 456,
    "borrowed": 1000.0,
    "date": "2023-09-04T12:00:00Z",
    "interest_accrued": 50.0,
    "interest_paid": 10.0,
    "interest_rate": 0.05,
    "repaid": 0.0,
    "last_interest_at": null,
    "opened_at": "2023-09-04T11:00:00Z",
    "type": "AUTO",
    "wallet_type": "SPOT"
}, ...]

Note

start_time and end_time interval must not exceed 30 days. If one is not set 30 days interval from set value is applied. If both are not set, default time interval is 30 days back from today. This method is disabled by default, set "Margin" flag during creation of an API-Key to use it.

Margin Repay History

GET /api/v3/margin/repay

Query Parameters

private_api.margin().repays('ETH', start_time=None, end_time=None)

Response

[{
    "id": 123,
    "account_id": 456,
    "interest_amount": 10.0,
    "principal_amount": 100.0,
    "currency": "USDT",
    "date": "2023-09-04T12:00:00Z",
    "type": "AUTO",
    "wallet_type": "SPOT"
}
...]

Note

start_time and end_time interval must not exceed 30 days. If one is not set 30 days interval from set value is applied. If both are not set, default time interval is 30 days back from today. This method is disabled by default, set "Margin" flag during creation of an API-Key to use it.

Margin Interest History

GET /api/v3/margin/interest

Query Parameters

private_api.margin().interests('ETH', start_time=None, end_time=None)

Response

[{
    "id": 123,
    "account_id": 456,
    "borrow_id": 789,
    "currency": "USDT",
    "interest_accrued": 50.0,
    "interest_paid": 10.0,
    "interest_rate": 0.05,
    "wallet_type": "SPOT"
}, ...]

Note

start_time and end_time interval must not exceed 30 days. If one is not set 30 days interval from set value is applied. If both are not set, default time interval is 30 days back from today. This method is disabled by default, set "Margin" flag during creation of an API-Key to use it.

Margin Liquidation History

GET /api/v3/margin/liquidation

Query Parameters

private_api.margin().liquidations('ETH', start_time=None, end_time=None)

Response

[{
  "id": 293878,
  "account_id": 25,
  "created_at": "2022-10-06T08:28:06.801064-04:00",
  "wallet_type": "ISOLATED_MARGIN",
  "margin_level": 0.002,
  "closed_at": "",
  "amount": 0.015,
  "fund_amount": 0.03,
  "currency": "ETH",
  "order_closed": [1, 3],
  "order_created": [5],
  "borrow_closed": [22, 41],
  "repay_created": [54]
}...]

Note

start_time and end_time interval must not exceed 30 days. If one is not set 30 days interval from set value is applied. If both are not set, default time interval is 30 days back from today. This method is disabled by default, set "Margin" flag during creation of an API-Key to use it.

WebSocket API

The WebSocket service by Alp Exchange is a real-time communication platform for traders. It offers public channels for accessing market data like prices and order book updates, as well as private (authenticated) channels for personal fund and order change notifications. This service ensures quick access to trading information, secure authentication, efficient order management, and an enhanced user experience, catering to the needs of both public and private traders. The service is available on wss://www.alp.com/alp-ws.

import asyncio
from pprint import pprint

from alpcom_api import ws, clients, cache
from alpcom_api.dto import ws as dto


class MyHandler(ws.Handler):
    def on_ticker(self, ticker: dto.Ticker):
        pprint(ticker)

    def on_trade(self, trade: dto.Trade):
        pprint(trade)

    def on_rate(self, rate: dto.Rate):
        pprint(rate)

    def on_diff(self, diff: dto.Diff):
        pprint(diff)

    def on_depth(self, depth: dto.Depth):
        pprint(depth)

    def on_wallet(self, wallet: dto.Wallet):
        pprint(wallet)

    def on_order(self, order: dto.Order):
        pprint(order)

async def main():
    async with ws.Client(handler=MyHandler()) as client:
        await client.subscribe(ws.tps.tickers_all)
        await client.receive_messages()


asyncio.get_event_loop().run_until_complete(main())

Ping

1. Ping Message: The server initiates the process by sending a "ping" message, string 1 to the client at regular intervals, every 20 seconds by default.
2. Pong Message: Upon receiving the ping message, the client responds with a "pong" message, string 2 to acknowledge that it's still active and responsive.
3. Connection Monitoring: The server keeps track of the time since the last ping message was sent. If it doesn't receive a corresponding pong message within a set timeframe, 30 seconds by default, it interprets this as an unresponsive client.
4. Connection Closure: In the event that the server doesn't receive a pong message within the specified time frame (30 seconds by default), it takes action to close the connection. This action can include terminating the connection to free up server resources and maintain system efficiency.

Topic Subscription

Message to subscribe on topics: ["subscribe", "topic1", "topic2", ...]

Message to unsubscribe: ["unsubscribe", "topic1", "topic2", ...]

The server will respond on subscription or unsubscription with next messages ["subscribe",1586857703.901509,"topic1","topic1"] ["unsubscribe",1586857703.901509,"topic1","topic1"]

In case of any error, the server will send next message: ["error",1586857703.901509,"Topic does not exist"]

Welcome

The welcome message gets sent when a connection is established. This message provides important initialization information for the client to ensure a smooth and responsive communication experience.

Message Fields 1. Type (Index 0): The type of the message is set to "welcome," indicating that it's a welcome message. 2. Time (Index 1): A floating-point number representing the timestamp of the message. 3. PingInterval (Index 2): An integer representing the ping interval in nanoseconds. This specifies how often the client should send ping messages to the server to maintain the connection. 4. PingTimeout (Index 3): An integer representing the ping timeout in nanoseconds. If the server does not receive a ping response from the client within this timeout period, it may consider the connection as unresponsive and take appropriate action. 5. ClientID (Index 4): A unique identifier (UUID) for the client, allowing the server to distinguish between different clients.

Event

["welcome", 1694002700, 30000000000, 65000000000, "5c00d9c2-607e-4c7f-927b-b204b29e387b"]

Ticker

Topics: ticker.*, ticker.XXX_YYY

Fields:

• Type: The type of the message is set to "tk," indicating that it's a ticker message.
• Timestamp: The Unix timestamp of the ticker data.
• Ticker 1: Ticker array.
• Ticker 2. Ticker array.
• Ticker n. Ticker array.

Each ticker array includes following fields:

• Trading Pair Symbol
• Close Price
• Base Volume
• Quote Volume
• Change Percent
• High Price
• Low Price
• Bid Price
• Ask Price

Example

[
  "tk",
  1694003337,
  ["XRP_USDT", "0.50057000", "2036106.67737645", "1024194.48541761", "-0.28287417", "0.50677000", "0.49872000", "0.50057000", "0.50117000"],
  ["BTC_USDT", "25725.53000000", "6074.90520117", "156489295.23543299", "0.09369121", "25889.00000000", "25629.43000000", "25717.69000000", "25747.69000000"],
  ["LTC_USDT", "63.06000000", "19800.19751964", "1248404.62483421", "0.39802579", "63.63000000", "62.60000000", "63.03000000", "63.06000000"],
  ["DOGE_USDT", "0.06389400", "26360317.66603325", "1686644.45381961", "0.03131164", "0.06466200", "0.06354300", "0.06384708", "0.06396200"],
  ["ETH_USDT", "1632.69000000", "7379.92830702", "12057736.03072529", "0.10791388", "1648.02000000", "1625.16000000", "1632.69000000", "1635.28000000"],
  ["TRX_USDT", "0.07827864", "17930244.99331608", "1392304.80058763", "1.44319315", "0.07857449", "0.07710881", "0.07832800", "0.07842434"],
  ["USDC_USDT", "1.00130000", "2135117.29179469", "2136330.76840695", "0.08996401", "1.00190090", "0.99929970", "1.00160060", "1.00140000"]
]

from alpcom_api import ws
await client.subscribe(ws.tps.tickers_all)
await client.subscribe(ws.tps.tickers_of('BTC_USDT'))

Trade

Topics: trade.*, trade.XXX_YYY

Fields:

• Type: The type of the message is set to "t," indicating that it's a trade event.
• Timestamp: The Unix timestamp of the trade event.
• Trade ID: A unique identifier for the trade event.
• Trading Pair Symbol: The symbol representing the trading pair associated with the trade.
• Trade Amount: The amount of the trade, converted to a string.
• Trade Price: The price of the trade, converted to a string.
• Trade Direction: The direction of the trade, either "buy" or "sell.

Example

[
  "t",
  1694003848,
  293107798,
  "BTC_USDT",
  "0.20285052",
  "25705.02000000",
  "buy"
]

from alpcom_api import ws
await client.subscribe(ws.tps.trades_all)
await client.subscribe(ws.tps.trades_of('BTC_USDT'))

Rates

Topics: rates.*, rates.XXX_YYY

The rates channel provides real-time currency exchange rates for a wide range of cryptocurrencies on our platform. It calculates the value of each currency relative to a set of fixed benchmarks, including USDT, EUR, USD, BTC, and ETH. Even if there isn't a direct trading pair, it accurately computes the conversion rate, ensuring users have access to up-to-date and reliable exchange information.

Fields:

• Type: The type of the message is set to "r," indicating that it's a rates event.
• Timestamp: The Unix timestamp of the trade event.
• Payload: The payload is an array containing rate information.

Each rate is represented as an array with the following fields:

• Rate Value
• Base Currency Code
• Quote Currency Code

Example

[
  "r",
  1694004000,
  [
    ["1.25000000", "USD", "EUR"],
    ["0.50000000", "BTC", "ETH"],
    ["2.00000000", "ETH", "USDT"]
  ]
]

from alpcom_api import ws
await client.subscribe(ws.tps.rates_all)
await client.subscribe(ws.tps.rates_of('BTC_USDT'))

Orderbook Diff

Topics: diff.XXX_YYY

Fields:

• Type: The type of the message is set to "d," indicating that it's a market depth difference event.
• Timestamp: The Unix timestamp of the market depth difference data.
• Payload: The payload is an array containing market depth difference information.

Payload includes the following fields: - Symbol: The trading symbol associated with the market depth. - Asks: A two-dimensional array representing the updated ask side of the market depth. Each ask is an array with the price and quantity difference. - Bids: A two-dimensional array representing the updated bid side of the market depth. Each bid is an array with the price and quantity difference.

Example

[
  "d",
  1694004500,
  "BTC_USDT",
  [
    [["101.00", "5.0"], ["102.00", "3.0"]],
    [["99.00", "2.0"], ["98.50", "1.0"]]
  ]
]

from alpcom_api import ws
await client.subscribe(ws.tps.diff_of('BTC_USDT'))

Market Depth

Topics: market_depth.XXX_YYY

Fields:

• Type: The type of the message is set to "p," indicating that it's a market depth event.
• Timestamp: The Unix timestamp of the market depth data.
• Payload: Market depth object.

Market depth object includes the following fields:

• Asks: A two-dimensional array representing the ask side of the market depth. Each ask is an array with the price and quantity.
• Bids: A two-dimensional array representing the bid side of the market depth. Each bid is an array with the price and quantity.
• Symbol: The trading symbol associated with the market depth.
• TotalAsks: The total quantity of asks.
• TotalBids: The total quantity of bids.

Example

[
  "p",
  1694178331,
  {
    "Asks": [
      [
        "26100.11000000",
        "0.30200000"
      ],
      [
        "26149.68000000",
        "0.51800000"
      ]
    ],
    "Bids": [
      [
        "25768.09000000",
        "0.05900000"
      ],
      [
        "25748.38000000",
        "0.46300000"
      ]
    ],
    "Symbol": "BTC_USDT",
    "TotalAsks": "148953.50292677",
    "TotalBids": "148953.97125366"
  }
]

from alpcom_api import ws
await client.subscribe(ws.tps.depth_of('BTC_USDT'))

Auth

You can use JWT-token, mentioned above, that is used for access to private API to authorize within web socket connection. To make it send next message: ["auth", "Generated GWT Token"]

cli = clients.ALPAuthClient(
    key='**API_KEY**',
    secret='**API_KEY**',
)
await client.auth(cli)

Account Order Update

After the authorization, you will receive updates of your orders on trades.

Fields:

• Type: The type of the message is set to "o" indicating that it's an order event.
• Timestamp: The Unix timestamp of the message.
• Order Id: The unique identifier for the order.
• Symbol: The trading symbol associated with the order.
• Side: The side of the order (e.g., 'buy' or 'sell').
• Order Type: The type of order (e.g., 'limit' or 'market').
• Base Amount: The quantity of the base currency in the order.
• Limit Price: The specified price for a limit order.
• Amount Unfilled: The quantity of the order that remains unfilled.
• Amount Filled: The quantity of the order that has been filled.
• Amount Cancelled: The quantity of the order that has been cancelled.
• Value Filled: The total value of the order that has been filled.
• Price Avg: The average price at which the order has been filled.
• Done At: The timestamp indicating when the order was completed.
• Status: The current status of the order (e.g., 'open', 'completed', 'cancelled').
• Quote Amount: The amount in the quote currency.
• Wallet Type: The type of wallet associated with the order (e.g., 'spot', 'margin').
• Stop Price: The specified stop price for a stop order.
• Stop Operator: The operator for the stop price (e.g., 'greater_than', 'less_than').

[
  "o",
  1694178331,
  12345, 
  "BTC_UST", 
  "ASK", 
  "LIMIT", 
  "0.5", 
  "48000.00", 
  "0.2", 
  "0.3", 
  "0.0", 
  "14400.00", 
  "48000.00", 
  1631386242.567, 
  "FILLED", 
  "14400.00", 
  "SPOT", 
  "0.00", 
  ""
]

Account Wallet Update

After the authorization, you will receive updates of your balances after each change.

Fields:

• Type: The type of the message is set to "w" indicating that it's a wallet update event.
• Timestamp: The Unix timestamp of the message.
• Code: Represents the unique code associated with the item.
• Wallet Type: Indicates the type of wallet (e.g., 'spot', 'margin').
• Symbol: Denotes the symbol of margin isolated wallet.
• Balance: Reflects the current balance of the wallet.
• Reserve: Specifies the reserved amount for the wallet.

[
  "w",
  1694178331,
  "USDT", 
  "SPOT", 
  "", 
  "5.0", 
  "1.0"
]

HTTP Errors

HTTP API uses following error statuses: