zerocap_api

These details have not been verified by PyPI

Project links

Homepage

Project description

zerocap-api

Jump restapi

Jump websocket


Introduction

Websocket sdk dependency
pip install websocket>=0.2.1
pip install websocket-client>=1.6.1

sdk install
pip install zerocap-api

restapi

from zerocap_api import ZerocapRestClient
import uuid
import time
import hmac
import hashlib

# API key and secret are required, please contact zerocap to register.

api_key = "***" 
api_secret = "***"
client = ZerocapRestClient(api_key, api_secret, env='uat')

timestamp = int(time.time())
signature = hmac.new(api_secret.encode("utf-8"), str(timestamp).encode("utf-8"), hashlib.sha256).hexdigest()

1. Create an order


result = client.create_order(
                    symbol='USDT/AUD', 
                    side='buy', 
                    type='limit', 
                    amount='100', 
                    price='1000', 
                    coinroutes_customer_id=5,
                    )

Request parameters:

Parameter	required	data type	describe	Value range
symbol	true	string	Instrument	USDT/AUD
side	true	string	Side	buy sell
type	true	string	Type	limit
amount	true	string	Quantity
price	true	string	Price
coinroutes_customer_id	false	int	coinroutes_customer_id
client_order_id	false	string	client_order_id

Request parameters: examples (cannot be used directly, you need to replace your own parameters)

headers = {
    'api-key': api_key,
    'signature': signature,
    'Content-Type': 'application/json',
    'timestamp': str(timestamp),
}

data = 
{
    "symbol": "USDT/AUD",
    "side": "buy",
    "type": "limit",
    "amount": "1000",
    "price": "1000",
    "coinroutes_customer_id": 5,
}

Response data:

Parameter	required	data type	describe
id	true	string	Transaction ID
timestamp	true	long	Time
lastTradeTimestamp	true	long	Time
status	true	string	Status
type	true	string	Type
timeInForce	true	string	timeInForce
side	true	string	Side
price	true	float	Price
average	true	float	average
amount	true	float	Quantity
filled	true	float	filled
remaining	true	float	remaining
cost	true	float	cost
fee	true	float	fee
error_message	true	string	error_message
trades	true	string	trades
client_order_id	true	string	client_order_id

Response example:


{
	"id": "d8dabfbd-e541-4262-b6c2-9f841ef220f6",
	"timestamp": 1692346145000,
	"last_trade_timestamp": 1692346145000,
	"status": "closed",
	"symbol": "USDT/AUD",
	"type": "limit",
	"time_in_force": "FOK",
	"side": "sell",
	"price": 1,
	"average": 1.48249,
	"amount": 500,
	"filled": 500,
	"remaining": 0,
	"cost": 741.245,
	"fee": 0,
	"error_message": "",
	"client_order_id": "",
	"trades": [
		{
			"id": "e86fcf94-88e6-46d8-8cc6-e06891eab6cf",
			"timestamp": 1692346145000,
			"symbol": "USDT/AUD",
			"order": "d8dabfbd-e541-4262-b6c2-9f841ef220f6",
			"type": "limit",
			"side": "sell",
			"taker_or_maker": "taker",
			"price": 1.48249,
			"amount": 500,
			"cost": 741.245,
			"order_from": "coinroutes",
			"fee": 0,
			"counterparty": "Wu Han"
		}
	]
}

2. Fetch specific orders

result = client.fetch_order(
                        id='',
                        )

Request parameters:

Parameter	required	data type	describe	Value range
id	true	string	Transaction ID

Request parameters: examples (cannot be used directly, you need to replace your own parameters)

headers = {
    'api-key': api_key,
    'signature': signature,
    'Content-Type': 'application/json',
    'timestamp': str(timestamp),
}

data = 
{
    "id": "d8dabfbd-e541-4262-b6c2-9f841ef220f6",
}

Response data:

Parameter	required	data type	describe
id	true	string	Transaction ID
timestamp	true	long	Time
lastTradeTimestamp	true	long	Time
status	true	string	Status
type	true	string	Type
timeInForce	true	string	timeInForce
side	true	string	Side
price	true	float	Price
average	true	float	average
amount	true	float	Quantity
filled	true	float	filled
remaining	true	float	remaining
cost	true	float	cost
fee	true	float	fee
error_message	true	string	error_message
trades	true	string	trades
client_order_id	true	string	client_order_id

Response example:


{
	"id": "d8dabfbd-e541-4262-b6c2-9f841ef220f6",
	"timestamp": 1692346145000,
	"last_trade_timestamp": 1692346145000,
	"status": "closed",
	"symbol": "USDT/AUD",
	"type": "limit",
	"time_in_force": "FOK",
	"side": "sell",
	"price": 1,
	"average": 1.48249,
	"amount": 500,
	"filled": 500,
	"remaining": 0,
	"cost": 741.245,
	"fee": 0,
	"error_message": "",
	"trades": [
		{
			"id": "e86fcf94-88e6-46d8-8cc6-e06891eab6cf",
			"timestamp": 1692346145000,
			"symbol": "USDT/AUD",
			"order": "d8dabfbd-e541-4262-b6c2-9f841ef220f6",
			"type": "limit",
			"side": "sell",
			"taker_or_maker": "taker",
			"price": 1,
			"amount": 500,
			"cost": 741.245,
			"order_from": "coinroutes",
			"fee": 0,
			"counterparty": "Wu Han"
		}
	]
}

3. Batch fetch order

result = client.fetch_orders(
                    symbol='USDT/AUD',
                    end_datetime=int(time.time() * 1000),
                    start_datetime=int(time.time() * 1000 - 10*86400*1000),
                    limit=10,
                    )

Request parameters:

Parameter	required	data type	describe
symbol	false	string	symbol
start_datetime	false	string	start_datetime
end_datetime	false	string	end_datetime
page	false	string	page
limit	false	string	limit
ids	false	string	Transaction ids(null character string or id1,id2...)
status	false	string	status
sort_order	false	string	sort_order
order_type	false	string	order_type
side	false	string	side

Request parameters: examples (cannot be used directly, you need to replace your own parameters)

headers = {
    'api-key': api_key,
    'signature': signature,
    'Content-Type': 'application/json',
    'timestamp': str(timestamp),
}

data = 
{
    "symbol": "USDT/AUD",
    "start_datetime": 0,
    "end_datetime": 0,
    "page": 0,
    "limit": 0,
    "ids": "",
    "status": "",
    "sort_order": "",
    "order_type": "",
    "side": "",
}

Response data:

Parameter	required	data type	describe
id	true	string	Transaction ID
timestamp	true	long	timestamp
last_trade_timestamp	true	long	last_trade_timestamp
status	true	string	status
symbol	true	string	symbol
type	true	string	type
time_in_force	true	string	time_in_force
side	true	string	side
price	true	float	price
average	true	float	average
amount	true	float	amount
filled	true	float	filled
remaining	true	float	remaining
cost	true	float	cost
fee	true	float	fee
error_message	true	string	fee
trades	true	list	trades
total	true	int	total
page	true	int	page
client_order_id	true	string	client_order_id

Response example:


{
	"order_list": [
		{
			"id": "e1af8ae0-3247-4755-87ad-f683fed3aff5",
			"timestamp": 1690797504000,
			"last_trade_timestamp": 1690797504000,
			"status": "closed",
			"symbol": "USDT/AUD",
			"type": "market",
			"time_in_force": "FOK",
			"side": "buy",
			"price": 21.1,
			"average": 2.98442,
			"amount": 101,
			"filled": 101,
			"remaining": 0,
			"cost": 301.426,
			"fee": 0,
			"error_message": "",
			"client_order_id": "",
			"trades": [
				{
					"id": "e1b3329c-4fc3-455a-82ed-ab5497b286cc",
					"timestamp": 1690797504000,
					"symbol": "USDT/AUD",
					"order": "e1af8ae0-3247-4755-87ad-f683fed3aff5",
					"type": "market",
					"side": "buy",
					"taker_or_maker": "taker",
					"price": 21.1,
					"amount": 101,
					"cost": 301.426,
					"order_from": "coinroutes",
					"fee": 0,
					"counterparty": "zeal anonymous"
				}
			]
		}
	],
	"status": "success",
	"total": 14087,
	"page": 1
}

4. Request For quote


result = client.request_for_quote(
                    symbol='USDT/AUD', 
                    side='buy', 
                    quantity='100', 
                    client_order_id='', 
                    )

Request parameters:

Parameter	required	data type	describe	Value range
symbol	true	string	Symbol	USDT/AUD
side	true	string	Side	buy sell
quantity	true	string	Quantity
client_order_id	false	string	Client Order ID

Request parameters: examples (cannot be used directly, you need to replace your own parameters)

headers = {
    'api-key': api_key,
    'signature': signature,
    'Content-Type': 'application/json',
    'timestamp': str(timestamp),
}

data = 
{
    "symbol": "USDT/AUD",
    "side": "buy",
    "quantity": "100",
    "client_order_id": ""
}

Response data:

Parameter	required	data type	describe
rfq_id	true	string	RFQ ID
client_order_id	true	string	Client Order ID
quantity	true	float	Quantity
side	true	string	Side
symbol	true	string	Symbol
price	true	float	price
created	true	string	Side

Response example:


{
    "rfq_id": "3ec2f335-1995-4c59-9d3a-8e3a4d048d23",
    "client_order_id": "",
    "quantity": 100.0,
    "side": "buy",
    "symbol": "USDT/AUD",
    "price": 1.4882,
    "created": "2024-01-15T02:49:17.658142Z"
}

5. Get Instruments

result = client.get_instruments()

Request parameters: examples (cannot be used directly, you need to replace your own parameters)

headers = {
    'api-key': api_key,
    'signature': signature,
    'Content-Type': 'application/json',
    'timestamp': str(timestamp),
}

Response data:

Parameter	required	data type	describe
name	true	string	Name
type	true	string	Type
is_tradable	true	bool	Is Ttradable
quantity_precision	true	float	Quantity Precision
max_quantity	true	float	Max Quantity
min_quantity	true	float	Min Quantity
price_precision	true	float	Price Precision

Response example:

{
    "status": "successful",
    "instruments": [
        {
            "name": "USDT/AUD",
            "type": "SPOT",
            "is_tradable": false,
            "quantity_precision": 2.0,
            "max_quantity": 50000.0,
            "min_quantity": 1.0,
            "price_precision": 4.0
        }
    ]
}

6. Get Balances

result = client.get_balances()

Request parameters: examples (cannot be used directly, you need to replace your own parameters)

headers = {
    'api-key': api_key,
    'signature': signature,
    'Content-Type': 'application/json',
    'timestamp': str(timestamp),
}

Response data:

Parameter	required	data type	describe
status	true	string	Request status
datetime	true	string	Format time
timestamp	true	int	Millisecond timestamp

Response example:

{
    "status": "successful",
    "datetime": "2024-01-16T05:21:38Z",
    "timestamp": 1705382498277,
    "BTC": {"custody": {"free": 100, "total": 100, "used": 0}},
    "AUD": {
        "DiscountNote": {"free": 1080, "total": 1080, "used": 0},
        "YieldEntryNotes": {"free": 3, "total": 3, "used": 0},
        "custody": {"free": 3092.07032787879, "total": 3092.07032787879, "used": 0},
        "prime": {"free": 3024064.624523521, "total": 3024064.624523521, "used": 0},
        "prime_locked": {"free": 103.107987, "total": 103.107987, "used": 0},
    },
    "custody": {
        "CAD": {"free": 98111.56, "total": 98111.56, "used": 0},
        "ETH": {"free": 0, "total": 0, "used": 0},
    },
    "prime": {
        "AUD": {"free": 3024064.624523521, "total": 3024064.624523521, "used": 0},
        "BTC": {"free": 10.387466098753459, "total": 10.387466098753459, "used": 0},
    },
    "prime_locked": {
        "AUD": {"free": 103.107987, "total": 103.107987, "used": 0},
        "USDT": {"free": 12609.60579, "total": 12609.60579, "used": 0},
    },
    "savings": {
        "BTC": {"free": 0.1003151580555734, "total": 0.1003151580555734, "used": 0}
    },
    "staking": {"DIVI": {"free": 300, "total": 300, "used": 0}},
    "term_3M": {
        "USDT_ETH_TEST3_EA4E": {
            "free": 0.9939347875558201,
            "total": 0.9939347875558201,
            "used": 0,
        }
    },
    "term_6M": {
        "USDT_TRX_TEST4": {
            "free": 9.80542196309589,
            "total": 9.80542196309589,
            "used": 0,
        }
    },
    "unlock": {"BTC": {"free": 2.6246, "total": 2.6246, "used": 0}},
}

websocket

import hmac
import hashlib
from zerocap_api import ZerocapWebsocketClient

# API key and secret are required, please contact zerocap to register.

api_key = "***" 
api_secret = "***"
websocket = ZerocapWebsocketClient(api_key, api_secret, env='uat')

# Create Ws Connection

timestamp = int(time.time())
websocket_connect = websocket.create_connection(timestamp)
connect_result = websocket.recv(websocket_connect)
print(connect_result)


signature = hmac.new(api_secret.encode("utf-8"), str(timestamp).encode("utf-8"), hashlib.sha256).hexdigest()

Response example:

{
    "type": "message",
    "message":"Successfully connected."
}

{
    "type": "error",
    "error_code": "401",
    "error_message":"Unauthorized"
}

1. Subscribe to Market data


websocket.send({"type": 'price', "symbol": "USDT/AUD"})
while True:
    # Get messages
    message = websocket.recv(websocket_connect)
    print(f"Receiving message from server: \n{message}")

Request parameters:

Parameter	required	data type	describe	Value range
type	true	str	Subscription type	price
symbol	true	str	Transaction pairs	USDT/AUD

Request parameters: examples (cannot be used directly, you need to replace your own parameters)

header={"api-key": api_key, "signature": signature, "timestamp": str(timestamp)}

wss://dma-ws.zerocap.com/v2

Response data:

Parameter	required	data type	describe	Value range
type	true	str	type	price, message, error
data	false	json	data
data['timestamp']	true	str	time
data['symbol']	true	str	symbol
data['exchange']	true	str	exchange
data['bids']	true	list	bids
data['asks']	true	list	asks
message	false	str	description
error_code	false	str	error code
error_message	false	str	error message

Response example:

{
    "type": "error",
    "error_code": "400",
    "error_message":"invalid message"
}

{
    "type": "message",
    "message":"price Subscription successful."
}

{

    "type": "message",
    "message": "pong"
}

{
    "type": "price",
    "data": {
        'timestamp': 1692340935.4283478,
        'symbol': 'USDT/AUD',
        'exchange': 'zerocap',
        'bids': [
            [1.47386, 5000.0],
            [1.47238, 10000.0],
            [1.4709, 20000.0],
            [1.46941, 30000.0]
        ],
        'asks': [
            [1.57236, 5000.0],
            [1.57392, 10000.0],
            [1.57548, 20000.0],
            [1.57705, 30000.0]
        ]
    }
}

{
    "type": "message",
    "message":"Price stream unavailable."
}

2. Subscribe Order updates or transaction records


websocket.send({"type": 'order'})
while True:
    # Get  messages
    message = websocket.recv(websocket_connect)
    
    print(f"Receiving message from server: \n{message}")

Request parameters:

Parameter	required	data type	describe	Value range
type	true	str	Subscribed type	order

Request parameters: examples (cannot be used directly, you need to replace your own parameters)

header={"api-key": api_key, "signature": signature, "timestamp": str(timestamp)}

wss://dma-ws.zerocap.com/v2

order Response data:

Parameter	required	data type	describe	Value range
type	true	str	type	order, message, error
data	false	json	data
data['id']	true	str	id
data['timestamp']	true	str	timestamp
data['last_trade_timestamp']	true	str	last_trade_timestamp
data['status']	true	str	status
data['symbol']	true	str	symbol
data['type']	true	str	type
data['time_in_force']	true	str	time_in_force
data['side']	true	str	side
data['price']	true	float	price
data['average']	true	float	average
data['amount']	true	float	amount
data['filled']	true	float	filled
data['remaining']	true	str	remaining
data['cost']	true	float	cost
data['error_message']	true	str	error_message
data['fee']	true	str	fee
data['trades']	true	list	trades
message	false	str	description
error_code	false	str	error code
error_message	false	str	error message

Response example:


{
    "type": "error",
    "error_code": "400",
    "error_message":"invalid message"
}

{
    "type": "message",
    "message":"order Subscription successful."
}

{
    "type": "message",
    "message": "pong"
}

{
"type":"order",
"data":{
    "id":"f7fc4e4f-c099-4b18-a231-f032adc8ae87",
    "timestamp":1692354083000,
    "last_trade_timestamp":1692354083000,
    "status":"open",
    "symbol":"USDT/AUD",
    "type":"limit",
    "time_in_force":"FOK",
    "side":"buy",
    "price":3,
    "average":0,
    "amount":3,
    "filled":0,
    "remaining":3,
    "cost":9,
    "error_message":"",
    "fee":"0",
    "trades":[]
    }
}

{
"type":"order",
"data":{
    "id":"f7fc4e4f-c099-4b18-a231-f032adc8ae87",
    "timestamp":1692354083000,
    "last_trade_timestamp":1692354083000,
    "status":"closed",
    "symbol":"USDT/AUD",
    "type":"limit",
    "time_in_force":"FOK",
    "side":"buy",
    "price":3,
    "average":1.474899,
    "amount":3",
    "filled":3,
    "remaining":0,
    "cost":9,
    "error_message":"",
    "fee":"0",
    "trades":[{
        "id":"fa9cbef5-54ce-4a3a-8115-3db8af1f1617",
        "timestamp":1692354083000,
        "symbol":"USDT/AUD",
        "order":"f7fc4e4f-c099-4b18-a231-f032adc8ae87",
        "type":"limit",
        "side":"buy",
        "taker_or_maker":"taker",
        "price":1.474899,
        "amount":3,
        "cost":4.424,
        "order_from":"coinroutes",
        "counterparty":"Wu Han",
        "fee":"0"
        }]
    }
}

3. Subscribe transaction records


websocket.send({"type": 'trade'})
while True:
    # Get  messages
    message = websocket.recv(websocket_connect)
    
    print(f"Receiving message from server: \n{message}")

Request parameters:

Parameter	required	data type	describe	Value range
type	true	str	Subscribed type	trade

Request parameters: examples (cannot be used directly, you need to replace your own parameters)

header={"api-key": api_key, "signature": signature, "timestamp": str(timestamp)}

wss://dma-ws.zerocap.com/v2

Transaction Record Response data:

Parameter	required	data type	describe	Value range
type	true	str	type	trade,message, error
data	false	json	data
data['id']	true	str	id
data['timestamp']	true	str	timestamp
data['datetime']	true	str	datetime
data['symbol']	true	str	symbol
data['order']	true	str	order
data['type']	true	str	type
data['side']	true	str	side
data['takerOrMaker']	true	str	takerOrMaker
data['price']	true	float	price
data['amount']	true	float	amount
data['cost']	true	float	cost
data['orderFrom']	true	str	orderFrom
message	false	str	description
error_code	false	str	error code
error_message	false	str	error message

Response example:


{
    "type": "error",
    "error_code": "400",
    "error_message":"invalid message"
}

{
    "type": "message",
    "message":"trade Subscription successful."
}

{

    "type": "message",
    "message": "pong"
}

{
"type":"trade",
"data":{
    "id":"fa9cbef5-54ce-4a3a-8115-3db8af1f1617",
    "timestamp":"1692354083000",
    "symbol":"USDT/AUD",
    "order":"f7fc4e4f-c099-4b18-a231-f032adc8ae87",
    "type":"limit",
    "side":"buy",
    "takerOrMaker":"taker",
    "price":1.474899,
    "amount":3,
    "cost":4.424,
    "orderFrom":"coinroutes",
    "counterparty":"Wu Han"
    }
}

Project details

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

0.1.30

Feb 27, 2024

0.1.29

Feb 22, 2024

0.1.28

Feb 7, 2024

0.1.27

Feb 5, 2024

0.1.26

Jan 18, 2024

This version

0.1.25

Jan 18, 2024

0.1.24

Jan 18, 2024

0.1.23

Jan 16, 2024

0.1.22

Jan 16, 2024

0.1.21

Jan 16, 2024

0.1.20

Jan 16, 2024

0.1.19

Jan 16, 2024

0.1.18

Jan 16, 2024

0.1.17

Jan 16, 2024

0.1.16

Jan 16, 2024

0.1.15

Jan 16, 2024

0.1.14

Jan 16, 2024

0.1.13

Jan 16, 2024

0.1.12

Jan 16, 2024

0.1.11

Jan 16, 2024

0.1.10

Jan 16, 2024

0.1.9

Jan 16, 2024

0.1.8

Jan 16, 2024

0.1.7

Dec 21, 2023

0.1.6

Dec 21, 2023

0.1.5

Dec 13, 2023

0.1.4

Dec 4, 2023

0.1.3

Oct 17, 2023

0.1.2

Oct 17, 2023

0.1.1

Oct 17, 2023

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zerocap_api-0.1.25.tar.gz (12.8 kB view details)

Uploaded Jan 18, 2024 Source

File details

Details for the file zerocap_api-0.1.25.tar.gz.

File metadata

Download URL: zerocap_api-0.1.25.tar.gz
Upload date: Jan 18, 2024
Size: 12.8 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/4.0.2 CPython/3.8.6

File hashes

Hashes for zerocap_api-0.1.25.tar.gz
Algorithm	Hash digest
SHA256	`a69ffc551c0b48ddf65e7dcfe67885d834067262bc762355dc6f65fb11a36220`
MD5	`85d686e9d7bb55dc6f8ab71635c06d2c`
BLAKE2b-256	`a8f043c8a90f5b5e24e7a34fe17bc56e3a37f79f618853d77c7a608d11dfa863`