MexbtClient 0.0.1

MexbtClient 0.0.1

×

测试已测试✓
语言语言 Obj-CObjective C
许可证 MIT
发布上次发布2015年8月

由Ricardo Alves维护。

MexbtClient 0.0.1

meXBT交易所API的Objective C客户端库

使用方法

要运行示例项目，请克隆仓库，然后首先从示例目录运行`pod install`。

公共API

[MexbtClient productPairs];
[MexbtClient ticker:@"BTCMXN"];
[MexbtClient trades:@"BTCMXN" startIndex:-1 count:20];
[MexbtClient tradesByDate:@"BTCMXN" startDate:1416530012 endDate:1416559390];
[MexbtClient orderBook:@"BTCMXN"];

私有API

MexbtClient *client = [[MexbtClient alloc] init];
client.privateKey = @"<YOUR PRIVATE KEY>";
client.publicKey  = @"<YOUR PUBLIC  KEY>";
client.userId     = @"<YOUR USER ID / EMAIL";
client.isSandbox  = YES;

[client createMarketOrder:@"BTCUSD" side:@"buy" qty:@1.0 px:@342.99];
[client createLimitOrder:@"BTCUSD"  side:@"buy" qty:@1.0 px:@342.99];

NSDictionary *order = [client createOrder:@"BTCUSD" side:@"buy" orderType:0 qty:@1.0 px:@342.99];
NSInteger orderId = [order[@"serverOrderId"] integerValue];

[client modifyOrder:@"BTCUSD"    serverOrderId:orderId modifyAction:1];
[client moveOrderToTop:@"BTCUSD" serverOrderId:orderId];
[client executeOrder:@"BTCUSD"   serverOrderId:orderId];

[client cancelOrder:@"BTCUSD" serverOrderId:orderId];
[client cancelAll:@"BTCUSD"];

[client accountInfo];
[client balance];
[client accountTrades:@"BTCUSD" startIndex:-1 count:20];
[client orders];
[client depositAddresses];
[client depositAddress:@"BTC"]
[client withdraw:@"BTC" amount:@1.123456 sendToAddress:@"address"];

需求

安装

MexbtClient通过CocoaPods提供。要安装它，只需将以下行添加到您的Podfile：

pod "MexbtClient"
pod "IGDigest", "~> 1.1"

重要提示

  1. 除`depositAddress`返回`NSString *`外，所有函数返回`(NSDictionary *)`。
  2. 当meXBT API返回的不是HTTP状态码200或返回非JSON或空响应时，所有函数都返回`nil`。
  3. 遗憾的是，由于某些实现的细节，布尔JSON值（例如，`true`，`false`）存储为`(NSNumber *)`，使用`0`为`false`和`1`为`true`。因此，如果您想要获取`(NSNumber *) x`的`BOOL`值，您将使用`[x boolValue]`。
  4. 所有函数都假设meXBT API将按meXBT API文档中指定的方式返回期望的格式：1)公共API。2)私有API，否则将抛出一些异常；当您在代码中找到一些意想不到的行为时，请注意这一点。

开发

为了方便起见，您可以直接从Github仓库安装库到任何XCode中。

当您正在开发库而不是使用时，这样做才有意义。

您可以通过在Podfile中添加以下内容来实现：

pod 'MexbtClient', :git => 'https://github.com/Ahimta/mexbt-objective-c.git'
pod 'IGDigest', '~> 1.1'
git clone https://github.com/Ahimta/mexbt-objective-c.git
cd mexbt-objective-c/Example
pod install

然后在XCode中打开`mexbt-objective-c/Example/MexbtClient.xcworkspace`。

这个库主要由三个文件组成（其余的大部分是由CocoaPods生成的）

  1. mexbt-objective-c/Pod/Classes/MexbtClient.h
  2. mexbt-objective-c/Pod/Classes/MexbtClient.m
  3. mexbt-objective-c/Example/Tests/Tests.m

作者

阿卜杜拉·阿拉纳西里，[email protected]

许可协议

MexbtClient 的使用遵守 MIT 许可协议。有关更多信息，请参阅 LICENSE 文件。