diff --git a/src/api/routes/v2/addresses.ts b/src/api/routes/v2/addresses.ts
index 3ea1b3803..f09b59738 100644
--- a/src/api/routes/v2/addresses.ts
+++ b/src/api/routes/v2/addresses.ts
@@ -44,7 +44,7 @@ export const AddressRoutesV2: FastifyPluginAsync<
         operationId: 'get_address_transactions',
         summary: 'Get address transactions',
         description: `Retrieves a paginated list of confirmed transactions sent or received by a STX address or Smart Contract ID, alongside the total amount of STX sent or received and the number of STX, FT and NFT transfers contained within each transaction.
-        
+
         More information on Transaction types can be found [here](https://docs.stacks.co/understand-stacks/transactions#types).`,
         tags: ['Transactions'],
         params: AddressParamsSchema,
@@ -283,7 +283,8 @@ export const AddressRoutesV2: FastifyPluginAsync<
         params: Type.Object({
           principal: PrincipalSchema,
           token: Type.String({
-            description: 'fungible token identifier',
+            description:
+              'fungible token identifier, e.g. `SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token`',
             examples: [
               'SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token',
               'SP3Y2ZSH8P7D50B0VBTSX11S7XSG24M1VB9YFQA4K.token-aeusdc::aeUSDC',