A .NET library for the Guild Wars 2 API and game client.
Introduction · Installation · Usage · API Docs · API Keys
| ⚡ High Performance | Low-allocation JSON with System.Text.Json |
| 🔄 Async First | Stream data from both the API and game client |
| 🎯 Type Safe | Full nullability annotations for C# 8.0+ |
| 🧩 Pure C# | No native dependencies |
| 🌍 Cross-Platform | Runs anywhere .NET runs |
| 🚀 AOT Ready | Supports ahead-of-time compilation |
| 📜 MIT License | Free and open source |
using var httpClient = new HttpClient();
var gw2 = new Gw2Client(httpClient);
// Get today's daily achievements
var dailies = await gw2.Hero.Achievements.GetDailyAchievements();
// Get trading post prices
var prices = await gw2.Commerce.GetItemPriceById(19721); // Glob of Ectoplasm
Console.WriteLine($"Buy: {prices.Value.BestBid}, Sell: {prices.Value.BestAsk}");GW2SDK targets .NET Standard 2.0, supporting modern and legacy runtimes:
| Platform | Version |
|---|---|
| .NET | 8.0+ |
| .NET Framework | 4.6.2+ |
| Mono | 5.4+ |
| Xamarin.iOS | 10.14+ |
| Xamarin.Mac | 3.8+ |
| Xamarin.Android | 8.0+ |
| UWP | 10.0.16299+ |
| Unity | 2018.1+ |
Note: Game client integration (MumbleLink) requires Windows. Wine compatibility is untested.
Check the wiki for contributor guidelines and the documentation site for user guides.
Other ways to contribute:
- 🐛 Report a bug or 💡 request a feature
- 💬 Start a discussion for questions or feedback
- ✏️ Quick edit typos directly in your browser
Tip
GitHub Codespaces offers ~60 free hours/month.
| Resource | Description |
|---|---|
| Codecov | Test coverage reports |
| GW2 Wiki: API | Official API documentation |
| GW2 Wiki: Chat Links | Chat link format specification |
| GW2 Wiki: MumbleLink | MumbleLink structure format |
| API Explorer | Browse available endpoints |
| API Schema | Machine-readable endpoint data |
Made with ❤️ for the Guild Wars 2 community