{"id":22153028,"url":"https://github.com/matous-volf/clash-royale-dotnet","last_synced_at":"2026-04-26T20:31:08.465Z","repository":{"id":144383576,"uuid":"486731916","full_name":"matous-volf/clash-royale-dotnet","owner":"matous-volf","description":"An unofficial .NET wrapper for Supercell's Clash Royale API.","archived":false,"fork":false,"pushed_at":"2023-01-16T09:17:03.000Z","size":84,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-20T20:13:52.024Z","etag":null,"topics":["api","clash-royale","clashroyale","clashroyaledotnet","csharp","dotnet","royaleapi","supercell","unofficial","wrapper"],"latest_commit_sha":null,"homepage":"https://www.nuget.org/packages/ClashRoyaleDotNet","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matous-volf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-04-28T19:59:31.000Z","updated_at":"2024-10-16T19:46:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"c177e779-2ca8-41c0-a4e5-4820ecd5430b","html_url":"https://github.com/matous-volf/clash-royale-dotnet","commit_stats":null,"previous_names":["matousvolf/clash-royale-dotnet"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/matous-volf/clash-royale-dotnet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matous-volf%2Fclash-royale-dotnet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matous-volf%2Fclash-royale-dotnet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matous-volf%2Fclash-royale-dotnet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matous-volf%2Fclash-royale-dotnet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matous-volf","download_url":"https://codeload.github.com/matous-volf/clash-royale-dotnet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matous-volf%2Fclash-royale-dotnet/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32312156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T19:15:34.056Z","status":"ssl_error","status_checked_at":"2026-04-26T19:15:15.467Z","response_time":129,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","clash-royale","clashroyale","clashroyaledotnet","csharp","dotnet","royaleapi","supercell","unofficial","wrapper"],"created_at":"2024-12-02T01:16:15.786Z","updated_at":"2026-04-26T20:31:08.395Z","avatar_url":"https://github.com/matous-volf.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Clash Royale .NET\nAn unofficial .NET wrapper for Supercell's [Clash Royale API](https://developer.clashroyale.com/).\n\n## Installation\n1. Install the [NuGet package](https://www.nuget.org/packages/ClashRoyaleDotNet).\n2. Add the `ClashRoyaleAPI` namespace wherever you want to use it:\n\n   ```cs\n   using ClashRoyaleAPI;\n   ```\n\n## Usage\nAfter [installing](#installation), you'll be able to reference the classes and methods.\n\nIn order to use the API, you need to create an instance of the `ClashRoyale` class. In the constructor, pass an [API key](https://developer.clashroyale.com/#/getting-started):\n```cs\nClashRoyale clashRoyale = new(key:\"\u003cyour_key\u003e\");\n```\n\nOptionally, you can choose to use [RoyaleAPI proxy servers](https://docs.royaleapi.com/#/proxy) with the second parameter:\n```cs\nClashRoyale clashRoyale = new(key:\"\u003cyour_key\u003e\", useProxyServers:true);\n```\n\nBoth of these can be changed later by setting the `Key` and `UseProxyServers` properties.\n\n### Player information\nTo get information about a player, use the `GetPlayerByTag` method:\n```cs\nPlayer player = clashRoyale.GetPlayerByTag(tag:\"#2PRQQVR88\");\n```\n*Although in the official API it is divided into different requests, this information also contains the player's Battle log and upcoming Chests.*\n\n### Clan information\n\n#### By Tag\nTo get information about a particular Clan, use the `GetClanByTag` method:\n```cs\nClan clan = clashRoyale.GetClanByTag(tag: \"#L2QCY2VC\");\n```\n*Although in the official API it is divided into different requests, this information also contains the Clan's current and previous River races.*\n\n#### By properties\nTo get information about Clans searched by their properties, use the `GetClansBySearch` method:\n```cs\nSearchResultClan[] clans = clashRoyale.GetClansBySearch(name: \"HMaK\", locationID: 57000070, minMembers: 35, maxMembers: 45, minScore: 30000);\n```\n\n### Card information\nTo get information about all Cards, use the `GetAllCards` method:\n```cs\nCard[] cards = clashRoyale.GetAllCards();\n```\n\n### Challenges information\nTo get information about currently known Challenges, use the `GetCurrentChallenges` method:\n```cs\nChallengeChain[] challengeChains = clashRoyale.GetCurrentChallenges();\n```\n\n## API coverage\nThe [latest release](https://github.com/matousvolf/clash-royale-dotnet/releases/latest) covers these parts of the official API:\n- players\n- Clans\n- Cards\n- Challenges\n\nThese parts are not covered yet:\n- Tournaments\n- locations\n\n## Known issues\nBelow are currently known problems this package has:\n- Players' upcoming Chests don't include Royal Wild Chest. It seems Supercell only grants this information to [RoyaleAPI](https://royaleapi.com/).\n- Challenges returned from the `GetCurrentChallenges` method have invalid end times. This is caused by a bug in the official API.\n\nDue to the implementation in this package, both of these issues are going to be resolved the moment they get fixed in the official API.\n\n## Contact\nIf you encounter any bug or imperfection, please let me know by submitting an [issue](https://github.com/matousvolf/clash-royale-dotnet/issues).\n\nWith questions or anything else, send me an email to [matousvolfu@gmail.com](mailto:matousvolfu@gmail.com).\n\n---\n\nThis material is unofficial and is not endorsed by Supercell. For more information see [Supercell's fan content policy](https://www.supercell.com/fan-content-policy).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatous-volf%2Fclash-royale-dotnet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatous-volf%2Fclash-royale-dotnet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatous-volf%2Fclash-royale-dotnet/lists"}