Coin Flipper API - Dart/Flutter Client

Coin Flipper simulates random coin flips and records heads or tails outcomes with flip counts. Paid plans can simulate multiple flips per request and calculate percentages, streak lengths, and fairness indicators.

This is the Dart/Flutter client for the Coin Flipper API.

Installation

Add this to your pubspec.yaml:

dependencies:
  apiverve_coinflipper: ^1.2.2

Then run:

dart pub get
# or for Flutter
flutter pub get

Usage

import 'package:apiverve_coinflipper/apiverve_coinflipper.dart';

void main() async {
  final client = CoinflipperClient('YOUR_API_KEY');

  try {
    final response = await client.execute({
      'flips': 1
    });

    print('Status: ${response.status}');
    print('Data: ${response.data}');
  } catch (e) {
    print('Error: $e');
  }
}

Response

{
  "status": "ok",
  "error": null,
  "data": {
    "total_flips": 10,
    "flips": [
      "Tails",
      "Heads",
      "Heads",
      "Tails",
      "Tails",
      "Heads",
      "Tails",
      "Tails",
      "Tails",
      "Tails"
    ],
    "heads_count": 3,
    "tails_count": 7,
    "heads_percentage": 30,
    "tails_percentage": 70,
    "longest_streak": {
      "length": 4,
      "type": "Tails"
    },
    "first_flip": "Tails",
    "last_flip": "Tails",
    "is_fair": false
  }
}

API Reference

• API Home: Coin Flipper API
• Documentation: docs.apiverve.com/ref/coinflipper

Authentication

All requests require an API key. Get yours at apiverve.com.

License

MIT License - see LICENSE for details.

Built with Dart for APIVerve