Public/Get-GW2CommerceExchangeGems.ps1

<#
    .SYNOPSIS
        Calculates the exchange rate from gems to coins.
 
    .DESCRIPTION
        The Get-GW2CommerceExchangeGems cmdlet retrieves the current exchange rate for converting a specified amount of gems into coins.
 
    .PARAMETER Quantity
        The amount of gems to exchange.
 
    .EXAMPLE
        Get-GW2CommerceExchangeGems -Quantity 800
        Returns the amount of coins received for 800 gems.
 
    .NOTES
        API Endpoint: /v2/commerce/exchange/gems
    #>

function Get-GW2CommerceExchangeGems {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory = $true)]
        [int]$Quantity
    )

    $Uri = "https://api.guildwars2.com/v2/commerce/exchange/gems"

    If ($Quantity -gt 0) {
        $Uri += "?quantity=$Quantity"
    }

    try {
        Invoke-RestMethod -Uri $Uri -Method Get
    }
    catch {
        Write-Error "Failed to retrieve gem exchange rate: $_"
    }
}