feat: create new token holders route (#128)

.changeset/odd-foxes-march.md

@@ -0,0 +1,5 @@
+---
+"@stackspulse/server": minor
+---
+
+Create new `/tokens/holders` route.

apps/server/src/api/tokens/holders.get.ts

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { apiCacheConfig } from "~/lib/api";
+import { getValidatedQueryZod } from "~/lib/nitro";
+import { stacksClient } from "~/lib/stacks";
+
+const tokensHoldersRouteSchema = z.object({
+  token: z.string(),
+  limit: z.number().min(1).max(100).optional(),
+  offset: z.number().min(0).optional(),
+});
+
+type TokensHoldersRouteResponse = {
+  total_supply: string;
+  total: number;
+  results: {
+    address: string;
+    balance: string;
+  }[];
+};
+
+export default defineCachedEventHandler(async (event) => {
+  const query = await getValidatedQueryZod(event, tokensHoldersRouteSchema);
+
+  const limit = query.limit ?? 20;
+  const offset = query.offset ?? 0;
+
+  const data: TokensHoldersRouteResponse = (
+    await stacksClient.GET("/extended/v1/tokens/ft/{token}/holders", {
+      params: {
+        path: { token: query.token },
+        query: { limit, offset },
+      },
+    })
+  ).data;
+
+  return data;
+}, apiCacheConfig);

apps/server/src/api/tokens/transaction-volume.get.ts

@@ -7,6 +7,11 @@ const tokensTransactionVolumeRouteSchema = z.object({
   token: z.string(),
 });
 
+type TokensTransactionVolumeRouteResponse = {
+  date: string;
+  daily_volume: string;
+}[];
+
 export default defineCachedEventHandler(async (event) => {
   const query = await getValidatedQueryZod(
     event,
@@ -30,7 +35,7 @@ ORDER BY
     date;
   `;
 
-  const stats = result.map((row) => ({
+  const stats: TokensTransactionVolumeRouteResponse = result.map((row) => ({
     date: row.date.slice(0, 10),
     daily_volume: row.daily_volume,
   }));