flutter_iexcloud_api 1.0.1 icon indicating copy to clipboard operation
flutter_iexcloud_api: ^1.0.1 copied to clipboard

Flutter API Client to retrieve financial data using IEX Cloud data provider.

flutter_iexcloud_api #

Pub support Build Status

The IEX Cloud API client based on REST, has resource-oriented URLs, returns JSON-encoded responses, and returns standard HTTP response codes.

Note:

  • IEX Cloud authenticates your API requests using your account’s API tokens. To use any IEX Cloud API, you must pass an API token with each request. If you do not include your API token when making an API request, or use one that is incorrect or disabled, IEX Cloud returns an error.
  • Work in progress, Only REST Requests are supported.

For more details click here

Road map #

API CollectionStatusMilestone
Status1.0.0
Symbols1.0.0
Cryptocurrency1.0.0
News1.1.0
Stocks / Equities:technologist:1.1.0
Corporate Actions:technologist:1.2.0
Market Info:technologist:1.2.0
Forex / Currencies:technologist:1.3.0
Options:technologist:1.3.0
Futures:technologist:1.3.0
CEO Compensation:technologist:1.3.0
Treasuries:technologist:1.3.0
Commodities:technologist:1.4.0
Economic Data:technologist:1.4.0
Reference Data:technologist:1.5.0
Investors Exchange Data:technologist:1.6.0
Premium Data:technologist:2.0.0

Get started #

API Reference: https://iexcloud.io/docs/api/#api-reference

Add dependency #

dependencies:
  flutter_iexcloud_api: ^1.0.0

Super simple to use #

import 'package:flutter_iexcloud_api/flutter_iexcloud_api.dart';

late final IEXClientApi service = IEXClientApi(
  token: "<Your Token>",
);

final response = await service.cryptocurrencyPrice("btcbusd");

Configuration #

propertydescriptiondefault
token(required) API Token provided by iexcloud-
apiVersion(required) iexcloud API Versionstable (see: ApiVersion)
connectTimeoutIt occurs when url is opened timeout.5000
sendTimeoutIt occurs when url is sent timeout.30000
receiveTimeoutIt occurs when receiving timeout.30000

Interceptors #

For each client instance, We can add one or more interceptors, by which we can intercept requests, responses and errors before they are handled by then or catchError.

Simple interceptor example

import 'package:dio/dio.dart';
class CustomInterceptors extends Interceptor {
  @override
  void onRequest(RequestOptions options, RequestInterceptorHandler handler) {
    print('REQUEST[${options.method}] => PATH: ${options.path}');
    return super.onRequest(options, handler);
  }
  @override
  Future onResponse(Response response, ResponseInterceptorHandler handler) {
    print('RESPONSE[${response.statusCode}] => PATH: ${response.request?.path}');
    return super.onResponse(response, handler);
  }
  @override
  Future onError(DioError err, ErrorInterceptorHandler handler) {
    print('ERROR[${err.response?.statusCode}] => PATH: ${err.request.path}');
    return super.onError(err, handler);
  }
}

Registering the Interceptor

late final IEXClientApi service = IEXClientApi(
  token: "<Your Token>",
);
service.addInterceptor(CustomInterceptors());

Cleaning all interceptors

late final IEXClientApi service = IEXClientApi(
  token: "<Your Token>",
);
service.clearInterceptors();

For more details on how to use Interceptor, please check dio plugin page

This open source project implemented by Tiarê Balbi Bonamini , and the license is MIT. Data provided by IEX Cloud

Features and bugs #

Please file feature requests and bugs at the issue tracker.

Development Notes #

dartdoc #

Use dartdoc to generate HTML documentaton for your Dart package.

Reference: https://github.com/dart-lang/dartdoc#dartdoc

pana #

A library for analyzing Dart packages. It invokes executables from the Dart SDK (or from the Flutter SDK if the package uses Flutter).

Reference: https://pub.dev/packages/pana

2
likes
130
pub points
0%
popularity

Publisher

verified publisher icontiarebalbi.com

Flutter API Client to retrieve financial data using IEX Cloud data provider.

Homepage
View/report issues

Documentation

API reference

License

Icon for licenses.MIT (LICENSE)

Dependencies

dio, flutter

More

Packages that depend on flutter_iexcloud_api