v1.1.0: feat() enable uri encode for GET requests by default. add env var for tracing http requests.
This commit is contained in:
Tiago Siebler
51
README.md
51
README.md
@@ -4,12 +4,12 @@
|
||||
[][1]
|
||||
[](https://www.codefactor.io/repository/github/tiagosiebler/bitget-api) [](https://t.me/nodetraders)
|
||||
|
||||
|
||||
[][1]
|
||||
|
||||
[1]: https://www.npmjs.com/package/bitget-api
|
||||
|
||||
Node.js connector for the Bitget APIs and WebSockets:
|
||||
|
||||
- Complete integration with all Bitget APIs.
|
||||
- TypeScript support (with type declarations for most API requests & responses).
|
||||
- Over 100 integration tests making real API calls & WebSocket connections, validating any changes before they reach npm.
|
||||
@@ -18,14 +18,18 @@ Node.js connector for the Bitget APIs and WebSockets:
|
||||
- Browser support (via webpack bundle - see "Browser Usage" below).
|
||||
|
||||
## Installation
|
||||
|
||||
`npm install --save bitget-api`
|
||||
|
||||
## Issues & Discussion
|
||||
|
||||
- Issues? Check the [issues tab](https://github.com/tiagosiebler/bitget-api/issues).
|
||||
- Discuss & collaborate with other node devs? Join our [Node.js Algo Traders](https://t.me/nodetraders) engineering community on telegram.
|
||||
|
||||
## Related projects
|
||||
|
||||
Check out my related projects:
|
||||
|
||||
- Try my connectors:
|
||||
- [binance](https://www.npmjs.com/package/binance)
|
||||
- [bybit-api](https://www.npmjs.com/package/bybit-api)
|
||||
@@ -38,13 +42,17 @@ Check out my related projects:
|
||||
- [awesome-crypto-examples](https://github.com/tiagosiebler/awesome-crypto-examples)
|
||||
|
||||
## Documentation
|
||||
|
||||
Most methods pass values as-is into HTTP requests. These can be populated using parameters specified by Bitget's API documentation, or check the type definition in each class within this repository (see table below for convenient links to each class).
|
||||
|
||||
- [Bitget API Documentation](https://www.bitget.com/docs-v5/en/#rest-api).
|
||||
|
||||
## Structure
|
||||
|
||||
This connector is fully compatible with both TypeScript and pure JavaScript projects, while the connector is written in TypeScript. A pure JavaScript version can be built using `npm run build`, which is also the version published to [npm](https://www.npmjs.com/package/bitget-api).
|
||||
|
||||
The version on npm is the output from the `build` command and can be used in projects without TypeScript (although TypeScript is definitely recommended).
|
||||
|
||||
- [src](./src) - the whole connector written in TypeScript
|
||||
- [lib](./lib) - the JavaScript version of the project (built from TypeScript). This should not be edited directly, as it will be overwritten with each release.
|
||||
- [dist](./dist) - the webpack bundle of the project for use in browser environments (see guidance on webpack below).
|
||||
@@ -53,22 +61,24 @@ The version on npm is the output from the `build` command and can be used in pro
|
||||
---
|
||||
|
||||
## REST API Clients
|
||||
|
||||
Each REST API group has a dedicated REST client. To avoid confusion, here are the available REST clients and the corresponding API groups:
|
||||
| Class | Description |
|
||||
|:------------------------------------: |:---------------------------------------------------------------------------------------------: |
|
||||
| [SpotClient](src/spot-client.ts) | [Spot APIs](https://bitgetlimited.github.io/apidoc/en/spot/#introduction) |
|
||||
| [FuturesClient](src/futures-client.ts) | [Futures APIs](https://bitgetlimited.github.io/apidoc/en/mix/#introduction) |
|
||||
| [BrokerClient](src/broker-client.ts) | [Broker APIs](https://bitgetlimited.github.io/apidoc/en/broker/#introduction) |
|
||||
| [WebsocketClient](src/websocket-client.ts) | Universal client for all Bitget's Websockets |
|
||||
| Class | Description |
|
||||
|:------------------------------------: |:---------------------------------------------------------------------------------------------: |
|
||||
| [SpotClient](src/spot-client.ts) | [Spot APIs](https://bitgetlimited.github.io/apidoc/en/spot/#introduction) |
|
||||
| [FuturesClient](src/futures-client.ts) | [Futures APIs](https://bitgetlimited.github.io/apidoc/en/mix/#introduction) |
|
||||
| [BrokerClient](src/broker-client.ts) | [Broker APIs](https://bitgetlimited.github.io/apidoc/en/broker/#introduction) |
|
||||
| [WebsocketClient](src/websocket-client.ts) | Universal client for all Bitget's Websockets |
|
||||
|
||||
Examples for using each client can be found in:
|
||||
|
||||
- the [examples](./examples) folder.
|
||||
- the [awesome-crypto-examples](https://github.com/tiagosiebler/awesome-crypto-examples) repository.
|
||||
|
||||
If you're missing an example, you're welcome to request one. Priority will be given to [github sponsors](https://github.com/sponsors/tiagosiebler).
|
||||
|
||||
|
||||
### Usage
|
||||
|
||||
First, create API credentials on Bitget's website.
|
||||
|
||||
All REST clients have can be used in a similar way. However, method names, parameters and responses may vary depending on the API category you're using!
|
||||
@@ -122,7 +132,10 @@ For more examples, including how to use websockets with bitget, check the [examp
|
||||
|
||||
---
|
||||
|
||||
## Customise Logging
|
||||
## Logging
|
||||
|
||||
### Customise logging
|
||||
|
||||
Pass a custom logger which supports the log methods `silly`, `debug`, `notice`, `info`, `warning` and `error`, or override methods from the default logger as desired.
|
||||
|
||||
```javascript
|
||||
@@ -133,16 +146,22 @@ DefaultLogger.silly = () => {};
|
||||
|
||||
const ws = new WebsocketClient(
|
||||
{
|
||||
apiKey: 'API_KEY',
|
||||
apiSecret: 'API_SECRET',
|
||||
apiPass: 'API_PASS',
|
||||
apiKey: 'API_KEY',
|
||||
apiSecret: 'API_SECRET',
|
||||
apiPass: 'API_PASS',
|
||||
},
|
||||
DefaultLogger
|
||||
DefaultLogger,
|
||||
);
|
||||
```
|
||||
|
||||
### Debug HTTP requests
|
||||
|
||||
In rare situations, you may want to see the raw HTTP requets being built as well as the API response. These can be enabled by setting the `BITGETTRACE` env var to `true`.
|
||||
|
||||
## Browser Usage
|
||||
|
||||
Build a bundle using webpack:
|
||||
|
||||
- `npm install`
|
||||
- `npm build`
|
||||
- `npm pack`
|
||||
@@ -152,9 +171,13 @@ The bundle can be found in `dist/`. Altough usage should be largely consistent,
|
||||
---
|
||||
|
||||
## Contributions & Thanks
|
||||
|
||||
### Donations
|
||||
|
||||
#### tiagosiebler
|
||||
|
||||
Support my efforts to make algo trading accessible to all - register with my referral links:
|
||||
|
||||
- [Bybit](https://www.bybit.com/en-US/register?affiliate_id=9410&language=en-US&group_id=0&group_type=1)
|
||||
- [Binance](https://www.binance.com/en/register?ref=20983262)
|
||||
- [Bitget](https://partner.bitget.com/bg/ZNM295)
|
||||
@@ -162,10 +185,12 @@ Support my efforts to make algo trading accessible to all - register with my ref
|
||||
- [FTX](https://ftx.com/referrals#a=ftxapigithub)
|
||||
|
||||
Or buy me a coffee using any of these:
|
||||
|
||||
- BTC: `1C6GWZL1XW3jrjpPTS863XtZiXL1aTK7Jk`
|
||||
- ETH (ERC20): `0xd773d8e6a50758e1ada699bb6c4f98bb4abf82da`
|
||||
|
||||
### Contributions & Pull Requests
|
||||
|
||||
Contributions are encouraged, I will review any incoming pull requests. See the issues tab for todo items.
|
||||
|
||||
## Star History
|
||||
|
||||
Reference in New Issue
Block a user