/PolygonioSwift

Swift wrapper to connect to the Polygon.io API to fetch Stocks, Forex and Crypto data.

Primary LanguageSwiftMIT LicenseMIT

PolygonioSwift

CI Status

GitHub tag (latest SemVer)

License

Example

Simply import PolygonioSwift with:

import PolygonioSwift

then create a polygon swift object like:

let polygon = PolygonioSwift.Client(key: "YOUR_POLYGON_API_KEY")

and finally simply call any of the endpoints you want to get info from. The names are the same as in polygon.io docs.

polygon.tickers(sort: .type, type: nil, market: .Stocks, locale: nil, search: "AAPL", active: true) { (result:TickersQueryResponse?, err) in
    // check if we got any errors
    if let err = err {
        print(err)
    } else {
        // results will hold the full response as it comes from Polygon.io
        print(result)
        // the candle data is in an array inside results.tickers
        print(result?.tickers)
    }
}

Please take a look at the documentation to know what endpoints does polygon.io has and what info to expect back at https://polygon.io/docs/#getting-started.

To run the example project, clone this repo, and open iOS Example.xcworkspace from the iOS Example directory.

In the examples you can see more methods although all of them work in the same way just changes name and parameter that they will accept.

Requirements

You need to have a valid and working Polygon API Key. Please create an account at https://polygon.io/ to obtain a valid API key.

Installation

Swift Package Manager

Add this to your project as a dependency using Swift Package Manager.

Alternative installations options are shown below for legacy projects.

CocoaPods

If you are already using CocoaPods, just add the following line to your Podfile then run pod install.

pod 'PolygonioSwift'

Carthage

If you are already using Carthage, just add to your Cartfile:


github "toniremi/PolygonioSwift" ~> 0.1

Then run carthage update to build the framework and drag the built PolygonioSwift.framework into your Xcode project.

Author

Antoni Remeseiro Alfonso

License

PolygonioSwift is available under the MIT license. See the LICENSE file for more information.