hass-to-be-good/integrations/strike

Strike Bitcoin Sensor for Home Assistant

A custom Home Assistant integration that fetches Bitcoin price data from the Strike API and creates sensor entities for monitoring cryptocurrency prices.

Features

• 🔄 Real-time Bitcoin (BTC) price tracking from Strike API
• 💱 Configurable currency pairs (default: BTC/USD)
• ⏱️ Customizable update intervals
• 🔐 Secure API key storage
• 🎨 Home Assistant UI configuration flow
• 📊 Additional state attributes (currency, source, last update)
• 🛡️ Comprehensive error handling and logging
• ✨ Follows Home Assistant development best practices

Installation

HACS (Recommended)

1. Open HACS in your Home Assistant instance
2. Click on "Integrations"
3. Click the three dots in the top right corner
4. Select "Custom repositories"
5. Add the repository URL: https://git.martien.io/Martien/hass-to-be-good
6. Select category: "Integration"
7. Click "Add"
8. Search for "Strike Bitcoin" in HACS
9. Click "Download"
10. Restart Home Assistant

Manual Installation

1. Copy the custom_components/strike folder to your Home Assistant custom_components directory
2. Restart Home Assistant

Configuration

Prerequisites

You need a Strike API key to use this integration:

1. Visit Strike and create an account
2. Navigate to the API section in your Strike dashboard
3. Generate a new API key
4. Copy the API key for use in Home Assistant

Setup via UI

1. Go to Settings → Devices & Services
2. Click + Add Integration
3. Search for Strike Bitcoin
4. Enter your Strike API key
5. (Optional) Configure currency pair (default: BTCUSD)
6. (Optional) Set update interval in seconds (default: 300 seconds / 5 minutes)
7. Click Submit

Usage

Once configured, the integration will create a sensor entity:

• Entity ID: sensor.strike_btcusd
• State: Current Bitcoin price
• Unit: Currency (e.g., USD)
• Icon: mdi:bitcoin

State Attributes

The sensor provides additional information as attributes:

• currency: Target currency (e.g., USD)
• source: Currency pair (e.g., BTC/USD)
• last_update: Timestamp of last update

Example Automation

automation:
  - alias: "Bitcoin Price Alert"
    trigger:
      - platform: numeric_state
        entity_id: sensor.strike_btcusd
        above: 50000
    action:
      - service: notify.notify
        data:
          message: "Bitcoin price is above $50,000!"

Example Lovelace Card

type: entities
entities:
  - entity: sensor.strike_btcusd
    name: Bitcoin Price
    icon: mdi:bitcoin

Configuration Options

Options Flow

You can modify the integration settings after setup:

1. Go to Settings → Devices & Services
2. Find Strike Bitcoin integration
3. Click Configure
4. Adjust the update interval
5. Click Submit

Troubleshooting

Integration Not Loading

• Check Home Assistant logs for errors
• Verify API key is correct
• Ensure you have internet connectivity
• Restart Home Assistant

API Errors

Common errors and solutions:

• 401 Unauthorized: Invalid API key - regenerate in Strike dashboard
• 403 Forbidden: API key doesn't have required permissions
• Connection timeout: Check network connectivity or increase timeout in const.py

Enable Debug Logging

Add to your configuration.yaml:

logger:
  default: info
  logs:
    custom_components.strike: debug

Development

Repository Structure

hass-to-be-good/
├── custom_components/
│   └── strike/
│       ├── __init__.py          # Integration setup
│       ├── config_flow.py       # Configuration UI
│       ├── const.py             # Constants and configuration
│       ├── manifest.json        # Integration metadata
│       └── sensor.py            # Sensor implementation
├── .gitignore
├── hacs.json                    # HACS configuration
└── README.md

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Testing

Before submitting changes:

1. Test the integration in a Home Assistant development environment
2. Verify configuration flow works correctly
3. Check logs for errors or warnings
4. Ensure code follows Home Assistant style guidelines

Strike API Reference

This integration uses the Strike API v1:

• Base URL: https://api.strike.me
• Endpoint: /v1/rates/ticker
• Authentication: Bearer token (API key)
• Documentation: Strike API Docs

License

This project is provided as-is for educational and personal use.

Support

For issues, questions, or feature requests:

• Open an issue on Gitea
• Check existing issues for solutions
• Provide Home Assistant logs when reporting bugs

Changelog

Version 1.0.0

• Initial release
• Bitcoin price sensor with Strike API integration
• UI configuration flow
• Configurable update intervals
• Secure API key storage
• Comprehensive error handling

Acknowledgments

• Built for Home Assistant
• Uses Strike API
• Follows Home Assistant integration development guidelines