SwitchBot Open API v1.1
Smart Home Free key (no card)
GitHub stars1.2k
Forks84
Last activityOct 8, 2026
Open issues187
Repository: OpenWonderLabs/SwitchBotAPI ยท Data checked Oct 2026
About
SwitchBot's official Open API lets you control their smart buttons, plugs, curtains, locks, and sensors. You generate a token and secret directly in the SwitchBot phone app. No developer application or fee. Commands go through SwitchBot's cloud, so your devices need to stay online.
Details
Free to start. You may need a free key, but no credit card.
Auth: Free key (no card)
Rate limit: 10,000 API calls/day
Verified: 2026-09-13
Best for: smart-home automation devices
Setup
- Install the SwitchBot app and add your devices.
- Open the app's developer options to generate a token and secret.
- Note both values. Requests must be signed with the secret.
- List your devices through the /v1.1/devices endpoint.
- Send commands like turnOn, press, or setPosition to control them.
Example
GET https://api.switch-bot.com/v1.1/devices with token, sign, nonce, and t headersUse cases
- Press buttons and flip switches remotely
- Schedule curtains and plugs with your own automations
- Include SwitchBot devices in multi-brand smart home routines