Update page.mdx

Author: Amine Afia

apps/portal/src/app/insight/agents-and-llms/llmstxt/page.mdx

@@ -38,7 +38,7 @@ Insight is a powerful tool that lets you retrieve blockchain data from any EVM c
 ## API URL
 
 ```typescript
-const baseUrl = `https://${chainId}.insight.thirdweb.com`;
+const baseUrl = `https://{{chainId}}.insight.thirdweb.com`;
 ```
 
 ## Authentication
@@ -48,22 +48,22 @@ The API supports three authentication methods:
 ```typescript
 // 1. Header Authentication
 const headers = {
-	"x-client-id": "YOUR_CLIENT_ID", // thirdweb Client ID
+	"x-client-id": "{{clientId}}", // thirdweb Client ID
 };
 
 // 2. Query Parameter
-const url = `https://${chainId}.insight.thirdweb.com/v1/events?clientId=YOUR_CLIENT_ID`;
+const url = `https://{{chainId}}.insight.thirdweb.com/v1/events?clientId={{clientId}}`;
 
 // 3. Bearer Token
 const headers = {
-	Authorization: "Bearer YOUR_JWT_TOKEN",
+	Authorization: "Bearer {{jwtToken}}",
 };
 
 // Example using fetch with header auth
 async function getEvents() {
-	const response = await fetch(`https://${chainId}.insight.thirdweb.com/v1/events`, {
+	const response = await fetch(`https://{{chainId}}.insight.thirdweb.com/v1/events`, {
 		headers: {
-			"x-client-id": "YOUR_CLIENT_ID",
+			"x-client-id": "{{clientId}}",
 		},
 	});
 	return await response.json();
@@ -74,14 +74,16 @@ async function getEvents() {
 
 ### Chain IDs
 
-The API supports the following chain IDs (with 1 as default):
+The API supports chain IDs in the following format:
 
 ```typescript
-type ChainId = string; // Chain ID of the network you want to query
+interface ChainConfig {
+	chainId: number;  // Chain ID of the network you want to query
+}
 
 // Example: Using a specific chain
-const chainId = "<chainId>"; // Replace with your desired chain ID
-const baseUrl = `https://${chainId}.insight.thirdweb.com`;
+const chainId = "{{chainId}}"; // Replace with your desired chain ID
+const baseUrl = `https://{{chainId}}.insight.thirdweb.com`;
 ```
 
 ### Base Response Structure
@@ -128,25 +130,25 @@ interface BaseResponse<T> {
 
 ```typescript
 // 1. Get All Events
-async function getAllEvents() {
-	const response = await fetch(`https://${chainId}.insight.thirdweb.com/v1/events`, {
-		headers: { "x-client-id": "YOUR_CLIENT_ID" },
+async function getAllEvents(): Promise<BaseResponse<Event>> {
+	const response = await fetch(`https://{{chainId}}.insight.thirdweb.com/v1/events`, {
+		headers: { "x-client-id": "{{clientId}}" },
 	});
 	return await response.json();
 }
 
 // 2. Get Contract Events with Filtering
-async function getContractEvents(contractAddress: string) {
+async function getContractEvents(contractAddress: string): Promise<BaseResponse<Event>> {
 	const params = new URLSearchParams({
-		filter_block_number_gte: "17000000",
+		filter_block_number_gte: "{{blockNumber}}",
 		sort_by: "block_timestamp",
 		sort_order: "desc",
 		limit: "50",
 	});
 
-	const url = `https://${chainId}.insight.thirdweb.com/v1/events/${contractAddress}?${params}`;
+	const url = `https://{{chainId}}.insight.thirdweb.com/v1/events/${contractAddress}?${params}`;
 	const response = await fetch(url, {
-		headers: { "x-client-id": "YOUR_CLIENT_ID" },
+			headers: { "x-client-id": "{{clientId}}" },
 	});
 	return await response.json();
 }
@@ -156,10 +158,10 @@ async function getContractEvents(contractAddress: string) {
 
 ```typescript
 // 1. Get ERC20 Balances
-async function getERC20Balances(ownerAddress: string) {
+async function getERC20Balances(ownerAddress: string): Promise<ERC20Response> {
 	const response = await fetch(
-		`https://${chainId}.insight.thirdweb.com/v1/tokens/erc20/${ownerAddress}`,
-		{ headers: { "x-client-id": "YOUR_CLIENT_ID" } },
+		`https://{{chainId}}.insight.thirdweb.com/v1/tokens/erc20/${ownerAddress}`,
+		{ headers: { "x-client-id": "{{clientId}}" } },
 	);
 	const data = await response.json();
 	// Example response:
@@ -177,8 +179,8 @@ async function getERC20Balances(ownerAddress: string) {
 // 2. Get NFT Balances
 async function getNFTBalances(ownerAddress: string) {
 	const response = await fetch(
-		`https://${chainId}.insight.thirdweb.com/v1/tokens/erc721/${ownerAddress}`,
-		{ headers: { "x-client-id": "YOUR_CLIENT_ID" } },
+		`https://{{chainId}}.insight.thirdweb.com/v1/tokens/erc721/${ownerAddress}`,
+		{ headers: { "x-client-id": "{{clientId}}" } },
 	);
 	const data = await response.json();
 	// Example response:
@@ -202,15 +204,15 @@ async function getNFTBalances(ownerAddress: string) {
 async function getFilteredEvents() {
 	const params = new URLSearchParams({
 		// Block filters
-		filter_block_number_gte: "17000000",
-		filter_block_number_lte: "17859301",
+		filter_block_number_gte: "{{startBlock}}",
+		filter_block_number_lte: "{{endBlock}}",
 
 		// Time filters
-		filter_block_timestamp_gte: "1715222400",
+		filter_block_timestamp_gte: "{{startTimestamp}}",
 
 		// Transaction filters
-		filter_from_address: "0x123...",
-		filter_value_gte: "1000000000000000000", // 1 ETH
+		filter_from_address: "{{fromAddress}}",
+		filter_value_gte: "{{minValue}}", // 1 ETH
 
 		// Pagination
 		page: "0",
@@ -222,8 +224,8 @@ async function getFilteredEvents() {
 	});
 
 	const response = await fetch(
-		`https://${chainId}.insight.thirdweb.com/v1/events?${params}`,
-		{ headers: { "x-client-id": "YOUR_CLIENT_ID" } },
+		`https://{{chainId}}.insight.thirdweb.com/v1/events?${params}`,
+		{ headers: { "x-client-id": "{{clientId}}" } },
 	);
 	return await response.json();
 }
@@ -234,8 +236,8 @@ async function getFilteredEvents() {
 ```typescript
 async function safeApiCall() {
 	try {
-		const response = await fetch(`https://${chainId}.insight.thirdweb.com/v1/events`, {
-			headers: { "x-client-id": "YOUR_CLIENT_ID" },
+		const response = await fetch(`https://{{chainId}}.insight.thirdweb.com/v1/events`, {
+			headers: { "x-client-id": "{{clientId}}" },
 		});
 
 		if (!response.ok) {
@@ -260,69 +262,73 @@ async function safeApiCall() {
 1. **Get All Events**
 
 ```typescript
-GET /v1/events
+GET https://{{chainId}}.insight.thirdweb.com/v1/events
 ```
 
 2. **Get Contract Events**
 
 ```typescript
-GET /v1/events/:contractAddress
+GET https://{{chainId}}.insight.thirdweb.com/v1/events/:contractAddress
 ```
 
 3. **Get Specific Event Type**
 
 ```typescript
-GET /v1/events/:contractAddress/:signature
+GET https://{{chainId}}.insight.thirdweb.com/v1/events/:contractAddress/:signature
 ```
 
 ### Transactions API
 
 1. **Get All Transactions**
 
 ```typescript
-GET /v1/transactions
-GET /v1/transactions;
+GET https://{{chainId}}.insight.thirdweb.com/v1/transactions
 ```
 
 2. **Get Contract Transactions**
 
 ```typescript
-GET /v1/transactions/:contractAddress
+GET https://{{chainId}}.insight.thirdweb.com/v1/transactions/:contractAddress
 ```
 
 3. **Get Specific Transaction Type**
 
 ```typescript
-GET /v1/transactions/:contractAddress/:signature
+GET https://{{chainId}}.insight.thirdweb.com/v1/transactions/:contractAddress/:signature
 ```
 
 ### Token Balance API
 
 1. **ERC20 Balances**
 
 ```typescript
-GET /v1/tokens/erc20/:ownerAddress
+GET https://{{chainId}}.insight.thirdweb.com/v1/tokens/erc20/:ownerAddress
 
 interface ERC20Response {
-  data: {
-    tokenAddress: string;  // Required
-    balance: string;      // Required
-  }[];
+  data: ERC20Balance[];
+}
+
+interface ERC20Balance {
+  tokenAddress: string;
+  balance: string;
 }
 ```
 
 2. **ERC721 & ERC1155 Balances**
 
 ```typescript
-GET /v1/tokens/erc721/:ownerAddress
-GET /v1/tokens/erc1155/:ownerAddress
+GET https://{{chainId}}.insight.thirdweb.com/v1/tokens/erc721/:ownerAddress
+GET https://{{chainId}}.insight.thirdweb.com/v1/tokens/erc1155/:ownerAddress
+GET https://{{chainId}}.insight.thirdweb.com/v1/transactions
 
 interface TokenBalance {
-  data: {
-    collectionAddress: string;  // Required
-    tokenId: string;           // Required
-    balance: string;           // Required
-  }[];
+  data: NFTBalance[];
+}
+
+interface NFTBalance {
+  collectionAddress: string;
+  tokenId: string;
+  balance: string;
 }
 ```