@covalenthq/client-sdk 0.7.5 → 0.8.0

package/dist/esm/util/types/XykServiceTypes.d.ts

@@ -1,4 +1,4 @@
-import { Pagination } from "./GenericTypes";
+import { Pagination, ContractMetadata } from "./GenericTypes";
 export interface PoolResponse {
     /** * The timestamp when the response was generated. Useful to show data staleness to users. */
     updated_at: Date;
@@ -232,6 +232,8 @@ export interface PoolsDexDataItem {
     volume_7d_quote: number;
     /** * The fee 24h converted to fiat in `quote-currency`. */
     fee_24h_quote: number;
+    /** * The annual fee percentage. */
+    annualized_fee: number;
     /** * A prettier version of the volume 24h quote for rendering purposes. */
     pretty_volume_24h_quote: string;
     /** * A prettier version of the volume 7d quote for rendering purposes. */
@@ -288,6 +290,8 @@ export interface UniswapLikeToken {
     /** * The asset balance. Use `contract_decimals` to scale this balance for display purposes. */
     balance: bigint | null;
     quote: number;
+    /** * A prettier version of the quote for rendering purposes. */
+    pretty_quote: string;
     /** * The exchange rate for the requested quote currency. */
     quote_rate: number;
 }
@@ -303,6 +307,8 @@ export interface UniswapLikeTokenWithSupply {
     /** * The asset balance. Use `contract_decimals` to scale this balance for display purposes. */
     balance: bigint | null;
     quote: number;
+    /** * A prettier version of the quote for rendering purposes. */
+    pretty_quote: string;
     /** * The exchange rate for the requested quote currency. */
     quote_rate: number;
     /** * Total supply of this pool token. */
@@ -357,6 +363,108 @@ export interface TokenV2Volume {
     /** * The total volume 24h converted to fiat in `quote-currency`. */
     total_volume_24h_quote: number;
 }
+export interface NetworkExchangeTokenViewResponse {
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: Date;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: number;
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: string;
+    /** * List of response items. */
+    items: TokenV2VolumeWithChartData[];
+    /** * Pagination metadata. */
+    pagination: Pagination;
+}
+export interface TokenV2VolumeWithChartData {
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: string;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: string;
+    /** * The name of the DEX, eg: `uniswap_v2`. */
+    dex_name: string;
+    /** * Use the relevant `contract_address` to lookup prices, logos, token transfers, etc. */
+    contract_address: string;
+    /** * The string returned by the `name()` method. */
+    contract_name: string;
+    /** * The total liquidity unscaled value. */
+    total_liquidity: number;
+    /** * The total volume 24h unscaled value. */
+    total_volume_24h: number;
+    /** * The contract logo URL. */
+    logo_url: string;
+    /** * The ticker symbol for this contract. This field is set by a developer and non-unique across a network. */
+    contract_ticker_symbol: string;
+    /** * Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`. */
+    contract_decimals: number;
+    /** * The total amount of swaps in the last 24h. */
+    swap_count_24h: number;
+    /** * The exchange rate for the requested quote currency. */
+    quote_rate: number;
+    /** * The 24h exchange rate for the requested quote currency. */
+    quote_rate_24h: number;
+    /** * A prettier version of the exchange rate for rendering purposes. */
+    pretty_quote_rate: string;
+    /** * A prettier version of the 24h exchange rate for rendering purposes. */
+    pretty_quote_rate_24h: string;
+    /** * A prettier version of the total liquidity quote for rendering purposes. */
+    pretty_total_liquidity_quote: string;
+    /** * A prettier version of the 24h volume quote for rendering purposes. */
+    pretty_total_volume_24h_quote: string;
+    /** * The total liquidity converted to fiat in `quote-currency`. */
+    total_liquidity_quote: number;
+    /** * The total volume 24h converted to fiat in `quote-currency`. */
+    total_volume_24h_quote: number;
+    /** * The number of transactions in the last 24h. */
+    transactions_24h: number;
+    volume_timeseries_7d: VolumeTokenTimeseries[];
+    volume_timeseries_30d: VolumeTokenTimeseries[];
+    liquidity_timeseries_7d: LiquidityTokenTimeseries[];
+    liquidity_timeseries_30d: LiquidityTokenTimeseries[];
+    price_timeseries_7d: PriceTokenTimeseries[];
+    price_timeseries_30d: PriceTokenTimeseries[];
+}
+export interface VolumeTokenTimeseries {
+    /** * The name of the DEX, eg: `uniswap_v2`. */
+    dex_name: string;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: string;
+    /** * The current date. */
+    dt: string;
+    /** * The total volume unscaled for this day. */
+    total_volume: string;
+    /** * The volume in `quote-currency` denomination. */
+    volume_quote: number;
+    /** * A prettier version of the volume quote for rendering purposes. */
+    pretty_volume_quote: string;
+}
+export interface LiquidityTokenTimeseries {
+    /** * The name of the DEX, eg: `uniswap_v2`. */
+    dex_name: string;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: string;
+    /** * The current date. */
+    dt: string;
+    /** * The total liquidity unscaled up to this day. */
+    total_liquidity: string;
+    /** * The liquidity in `quote-currency` denomination. */
+    liquidity_quote: number;
+    /** * A prettier version of the liquidity quote for rendering purposes. */
+    pretty_liquidity_quote: string;
+}
+export interface PriceTokenTimeseries {
+    /** * The name of the DEX, eg: `uniswap_v2`. */
+    dex_name: string;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: string;
+    /** * The current date. */
+    dt: string;
+    /** * The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. */
+    quote_currency: string;
+    /** * The exchange rate for the requested quote currency. */
+    quote_rate: number;
+    /** * A prettier version of the exchange rate for rendering purposes. */
+    pretty_quote_rate: string;
+}
 export interface SupportedDexesResponse {
     /** * The timestamp when the response was generated. Useful to show data staleness to users. */
     updated_at: Date;
@@ -409,6 +517,30 @@ export interface ExchangeTransaction {
     total_quote: number;
     /** * A prettier version of the total quote for rendering purposes. */
     pretty_total_quote: string;
+    /** * The value attached to this tx. */
+    value: bigint | null;
+    /** * The value attached in `quote-currency` to this tx. */
+    value_quote: number;
+    /** * A prettier version of the quote for rendering purposes. */
+    pretty_value_quote: string;
+    /** * The requested chain native gas token metadata. */
+    gas_metadata: ContractMetadata;
+    /** * The amount of gas supplied for this tx. */
+    gas_offered: string;
+    /** * The gas spent for this tx. */
+    gas_spent: string;
+    /** * The gas price at the time of this tx. */
+    gas_price: string;
+    /** * The total transaction fees (`gas_price` * `gas_spent`) paid for this tx, denoted in wei. */
+    fees_paid: bigint | null;
+    /** * The gas spent in `quote-currency` denomination. */
+    gas_quote: number;
+    /** * A prettier version of the quote for rendering purposes. */
+    pretty_gas_quote: string;
+    /** * The native gas exchange rate for the requested `quote-currency`. */
+    gas_quote_rate: number;
+    /** * The requested quote currency eg: `USD`. */
+    quote_currency: string;
     token_0: PoolToken;
     token_1: PoolToken;
     token_0_quote_rate: number;
@@ -452,6 +584,18 @@ export interface TransactionsForExchangeResponse {
     /** * Pagination metadata. */
     pagination: Pagination;
 }
+export interface NetworkTransactionsResponse {
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: Date;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: number;
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: string;
+    /** * List of response items. */
+    items: ExchangeTransaction[];
+    /** * Pagination metadata. */
+    pagination: Pagination;
+}
 export interface EcosystemChartDataResponse {
     /** * The timestamp when the response was generated. Useful to show data staleness to users. */
     updated_at: Date;
@@ -472,13 +616,17 @@ export interface UniswapLikeEcosystemCharts {
     /** * The requested quote currency eg: `USD`. */
     quote_currency: string;
     gas_token_price_quote: number;
-    total_swaps24h: number;
-    total_active_pairs7d: number;
-    total_fees24h: number;
-    volume_chart7d: VolumeEcosystemChart[];
-    volume_chart30d: VolumeEcosystemChart[];
-    liquidity_chart7d: LiquidityEcosystemChart[];
-    liquidity_chart30d: LiquidityEcosystemChart[];
+    total_swaps_24h: number;
+    total_active_pairs_7d: number;
+    total_fees_24h: number;
+    /** * A prettier version of the gas quote for rendering purposes. */
+    pretty_gas_token_price_quote: string;
+    /** * A prettier version of the 24h total fees for rendering purposes. */
+    pretty_total_fees_24h: string;
+    volume_chart_7d: VolumeEcosystemChart[];
+    volume_chart_30d: VolumeEcosystemChart[];
+    liquidity_chart_7d: LiquidityEcosystemChart[];
+    liquidity_chart_30d: LiquidityEcosystemChart[];
 }
 export interface VolumeEcosystemChart {
     /** * The name of the DEX, eg: `uniswap_v2`. */
@@ -489,6 +637,8 @@ export interface VolumeEcosystemChart {
     /** * The requested quote currency eg: `USD`. */
     quote_currency: string;
     volume_quote: number;
+    /** * A prettier version of the volume quote for rendering purposes. */
+    pretty_volume_quote: string;
     swap_count_24: number;
 }
 export interface LiquidityEcosystemChart {
@@ -500,6 +650,8 @@ export interface LiquidityEcosystemChart {
     /** * The requested quote currency eg: `USD`. */
     quote_currency: string;
     liquidity_quote: number;
+    /** * A prettier version of the liquidity quote for rendering purposes. */
+    pretty_liquidity_quote: string;
 }
 export interface HealthDataResponse {
     /** * The timestamp when the response was generated. Useful to show data staleness to users. */

package/dist/services/BalanceService.d.ts

@@ -1,4 +1,4 @@
-import { Chain, Quote, Response } from "./CovalentClient";
+import { Chain, Quote, Response, ChainID, Source } from "./CovalentClient";
 import { Chains } from "../util/Chains";
 declare class BalancesResponse {
     /** * The requested address. */
@@ -445,7 +445,7 @@ export interface GetErc20TransfersForWalletAddressQueryParamOpts {
 }
 export interface GetTokenHoldersV2ForTokenAddressQueryParamOpts {
     /** * Ending block to define a block range. Omitting this parameter defaults to the latest block height. */
-    blockHeight?: number;
+    blockHeight?: number | string;
     /** * Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date. */
     date?: string;
     /** * Number of items per page. Note: Currently, only values of `100` and `1000` are supported. Omitting this parameter defaults to 100. */
@@ -465,7 +465,7 @@ export interface GetHistoricalTokenBalancesForWalletAddressQueryParamOpts {
     /** * If `true`, the response shape is limited to a list of collections and token ids, omitting metadata and asset information. Helpful for faster response times and wallets holding a large number of NFTs. */
     noNftAssetMetadata?: boolean;
     /** * Ending block to define a block range. Omitting this parameter defaults to the latest block height. */
-    blockHeight?: number;
+    blockHeight?: number | string;
     /** * Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date. */
     date?: string;
 }
@@ -473,7 +473,7 @@ export interface GetNativeTokenBalanceQueryParamOpts {
     /** * The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. */
     quoteCurrency?: Quote;
     /** * Ending block to define a block range. Omitting this parameter defaults to the latest block height. */
-    blockHeight?: number;
+    blockHeight?: number | string;
 }
 /**
  * Balances APIs
@@ -484,8 +484,10 @@ export declare class BalanceService {
     private debug;
     private threadCount;
     private is_key_valid;
+    private enableRetry;
+    private source;
     private LIMIT;
-    constructor(apiKey: string, debug: boolean, threadCount: number, is_key_valid: boolean);
+    constructor(apiKey: string, debug: boolean, threadCount: number, is_key_valid: boolean, enableRetry: boolean, source: Source);
     /**
      *
      * Commonly used to fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address. Response includes spot prices and other metadata.
@@ -500,7 +502,7 @@ export declare class BalanceService {
      *   - `noNftAssetMetadata`: If `true`, the response shape is limited to a list of collections and token ids, omitting metadata and asset information. Helpful for faster response times and wallets holding a large number of NFTs.
      *
      */
-    getTokenBalancesForWalletAddress(chainName: Chain | Chains, walletAddress: string, queryParamOpts?: GetTokenBalancesForWalletAddressQueryParamOpts): Promise<Response<BalancesResponse>>;
+    getTokenBalancesForWalletAddress(chainName: Chain | Chains | ChainID, walletAddress: string, queryParamOpts?: GetTokenBalancesForWalletAddressQueryParamOpts): Promise<Response<BalancesResponse>>;
     /**
      *
      * Commonly used to render a daily portfolio balance for an address broken down by the token. The timeframe is user-configurable, defaults to 30 days.
@@ -512,7 +514,7 @@ export declare class BalanceService {
      *   - `days`: The number of days to return data for. Defaults to 30 days.
      *
      */
-    getHistoricalPortfolioForWalletAddress(chainName: Chain | Chains, walletAddress: string, queryParamOpts?: GetHistoricalPortfolioForWalletAddressQueryParamOpts): Promise<Response<PortfolioResponse>>;
+    getHistoricalPortfolioForWalletAddress(chainName: Chain | Chains | ChainID, walletAddress: string, queryParamOpts?: GetHistoricalPortfolioForWalletAddressQueryParamOpts): Promise<Response<PortfolioResponse>>;
     /**
      *
      * Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address.
@@ -528,7 +530,7 @@ export declare class BalanceService {
      *   - `pageNumber`: 0-indexed page number to begin pagination.
      *
      */
-    getErc20TransfersForWalletAddress(chainName: Chain | Chains, walletAddress: string, queryParamOpts?: GetErc20TransfersForWalletAddressQueryParamOpts): AsyncIterable<BlockTransactionWithContractTransfers>;
+    getErc20TransfersForWalletAddress(chainName: Chain | Chains | ChainID, walletAddress: string, queryParamOpts?: GetErc20TransfersForWalletAddressQueryParamOpts): AsyncIterable<BlockTransactionWithContractTransfers>;
     /**
      *
      * Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address.
@@ -544,7 +546,7 @@ export declare class BalanceService {
      *   - `pageNumber`: 0-indexed page number to begin pagination.
      *
      */
-    getErc20TransfersForWalletAddressByPage(chainName: Chain | Chains, walletAddress: string, queryParamOpts?: GetErc20TransfersForWalletAddressQueryParamOpts): Promise<Response<Erc20TransfersResponse>>;
+    getErc20TransfersForWalletAddressByPage(chainName: Chain | Chains | ChainID, walletAddress: string, queryParamOpts?: GetErc20TransfersForWalletAddressQueryParamOpts): Promise<Response<Erc20TransfersResponse>>;
     /**
      *
      * Commonly used to get a list of all the token holders for a specified ERC20 or ERC721 token. Returns historic token holders when block-height is set (defaults to `latest`). Useful for building pie charts of token holders.
@@ -558,7 +560,7 @@ export declare class BalanceService {
      *   - `date`: Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date.
      *
      */
-    getTokenHoldersV2ForTokenAddress(chainName: Chain | Chains, tokenAddress: string, queryParamOpts?: GetTokenHoldersV2ForTokenAddressQueryParamOpts): AsyncIterable<TokenHolder>;
+    getTokenHoldersV2ForTokenAddress(chainName: Chain | Chains | ChainID, tokenAddress: string, queryParamOpts?: GetTokenHoldersV2ForTokenAddressQueryParamOpts): AsyncIterable<TokenHolder>;
     /**
      *
      * Commonly used to get a list of all the token holders for a specified ERC20 or ERC721 token. Returns historic token holders when block-height is set (defaults to `latest`). Useful for building pie charts of token holders.
@@ -572,7 +574,7 @@ export declare class BalanceService {
      *   - `date`: Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date.
      *
      */
-    getTokenHoldersV2ForTokenAddressByPage(chainName: Chain | Chains, tokenAddress: string, queryParamOpts?: GetTokenHoldersV2ForTokenAddressQueryParamOpts): Promise<Response<TokenHoldersResponse>>;
+    getTokenHoldersV2ForTokenAddressByPage(chainName: Chain | Chains | ChainID, tokenAddress: string, queryParamOpts?: GetTokenHoldersV2ForTokenAddressQueryParamOpts): Promise<Response<TokenHoldersResponse>>;
     /**
      *
      * Commonly used to fetch the historical native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address at a given block height or date. Response includes daily prices and other metadata.
@@ -589,7 +591,7 @@ export declare class BalanceService {
      *   - `date`: Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date.
      *
      */
-    getHistoricalTokenBalancesForWalletAddress(chainName: Chain | Chains, walletAddress: string, queryParamOpts?: GetHistoricalTokenBalancesForWalletAddressQueryParamOpts): Promise<Response<HistoricalBalancesResponse>>;
+    getHistoricalTokenBalancesForWalletAddress(chainName: Chain | Chains | ChainID, walletAddress: string, queryParamOpts?: GetHistoricalTokenBalancesForWalletAddressQueryParamOpts): Promise<Response<HistoricalBalancesResponse>>;
     /**
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
@@ -599,6 +601,6 @@ export declare class BalanceService {
      *   - `blockHeight`: Ending block to define a block range. Omitting this parameter defaults to the latest block height.
      *
      */
-    getNativeTokenBalance(chainName: Chain | Chains, walletAddress: string, queryParamOpts?: GetNativeTokenBalanceQueryParamOpts): Promise<Response<TokenBalanceNativeResponse>>;
+    getNativeTokenBalance(chainName: Chain | Chains | ChainID, walletAddress: string, queryParamOpts?: GetNativeTokenBalanceQueryParamOpts): Promise<Response<TokenBalanceNativeResponse>>;
 }
 export {};

package/dist/services/BalanceService.js

@@ -285,11 +285,13 @@ class NativeBalanceItem {
  *
  */
 export class BalanceService {
-    constructor(apiKey, debug = false, threadCount = 3, is_key_valid) {
+    constructor(apiKey, debug = false, threadCount = 3, is_key_valid, enableRetry = true, source) {
         this.apiKey = apiKey;
         this.debug = debug;
         this.threadCount = threadCount;
         this.is_key_valid = is_key_valid;
+        this.enableRetry = enableRetry;
+        this.source = source;
         this.LIMIT = pLimit(this.threadCount);
     }
     /**
@@ -337,6 +339,7 @@ export class BalanceService {
                 if (queryParamOpts?.noNftAssetMetadata !== undefined) {
                     urlParams.append("no-nft-asset-metadata", queryParamOpts?.noNftAssetMetadata.toString());
                 }
+                const url = `https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/balances_v2/?${urlParams}`;
                 let startTime;
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
@@ -344,13 +347,13 @@ export class BalanceService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/balances_v2/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
-                debugOutput(response.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
+                if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response.url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -380,8 +383,8 @@ export class BalanceService {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    error_code: error.cause ? error.cause.code : data ? data.error_code : response ? response.status : "Unknown Error Code",
+                    error_message: error.cause ? error.cause.message : data ? data.error_message : response && response.status === 500 ? "Internal server error" : !response ? "Unknown Error" : "401 Authorization Required"
                 };
             }
         }
@@ -419,6 +422,7 @@ export class BalanceService {
                 if (queryParamOpts?.days !== undefined) {
                     urlParams.append("days", queryParamOpts?.days.toString());
                 }
+                const url = `https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/portfolio_v2/?${urlParams}`;
                 let startTime;
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
@@ -426,13 +430,13 @@ export class BalanceService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/portfolio_v2/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
-                debugOutput(response.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
+                if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response.url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -462,8 +466,8 @@ export class BalanceService {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    error_code: error.cause ? error.cause.code : data ? data.error_code : response ? response.status : "Unknown Error Code",
+                    error_message: error.cause ? error.cause.message : data ? data.error_message : response && response.status === 500 ? "Internal server error" : !response ? "Unknown Error" : "401 Authorization Required"
                 };
             }
         }
@@ -510,7 +514,7 @@ export class BalanceService {
                 if (queryParamOpts?.pageNumber !== undefined) {
                     urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
                 }
-                for await (res of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transfers_v2/`, this.apiKey, urlParams, BlockTransactionWithContractTransfers, this.debug, this.threadCount)) {
+                for await (res of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transfers_v2/`, this.apiKey, urlParams, BlockTransactionWithContractTransfers, this.debug, this.threadCount, this.enableRetry, this.source)) {
                     yield res;
                 }
                 success = true;
@@ -570,6 +574,7 @@ export class BalanceService {
                 if (queryParamOpts?.pageNumber !== undefined) {
                     urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
                 }
+                const url = `https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transfers_v2/?${urlParams}`;
                 let startTime;
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
@@ -577,13 +582,13 @@ export class BalanceService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transfers_v2/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
-                debugOutput(response.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
+                if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response.url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -613,8 +618,8 @@ export class BalanceService {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    error_code: error.cause ? error.cause.code : data ? data.error_code : response ? response.status : "Unknown Error Code",
+                    error_message: error.cause ? error.cause.message : data ? data.error_message : response && response.status === 500 ? "Internal server error" : !response ? "Unknown Error" : "401 Authorization Required"
                 };
             }
         }
@@ -653,7 +658,7 @@ export class BalanceService {
                 if (queryParamOpts?.date !== undefined) {
                     urlParams.append("date", queryParamOpts?.date.toString());
                 }
-                for await (res of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/tokens/${tokenAddress}/token_holders_v2/`, this.apiKey, urlParams, TokenHolder, this.debug, this.threadCount)) {
+                for await (res of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/tokens/${tokenAddress}/token_holders_v2/`, this.apiKey, urlParams, TokenHolder, this.debug, this.threadCount, this.enableRetry, this.source)) {
                     yield res;
                 }
                 success = true;
@@ -705,6 +710,7 @@ export class BalanceService {
                 if (queryParamOpts?.date !== undefined) {
                     urlParams.append("date", queryParamOpts?.date.toString());
                 }
+                const url = `https://api.covalenthq.com/v1/${chainName}/tokens/${tokenAddress}/token_holders_v2/?${urlParams}`;
                 let startTime;
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
@@ -712,13 +718,13 @@ export class BalanceService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/tokens/${tokenAddress}/token_holders_v2/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
-                debugOutput(response.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
+                if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response.url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -748,8 +754,8 @@ export class BalanceService {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    error_code: error.cause ? error.cause.code : data ? data.error_code : response ? response.status : "Unknown Error Code",
+                    error_message: error.cause ? error.cause.message : data ? data.error_message : response && response.status === 500 ? "Internal server error" : !response ? "Unknown Error" : "401 Authorization Required"
                 };
             }
         }
@@ -807,6 +813,7 @@ export class BalanceService {
                 if (queryParamOpts?.date !== undefined) {
                     urlParams.append("date", queryParamOpts?.date.toString());
                 }
+                const url = `https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/historical_balances/?${urlParams}`;
                 let startTime;
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
@@ -814,13 +821,13 @@ export class BalanceService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/historical_balances/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
-                debugOutput(response.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
+                if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response.url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -850,8 +857,8 @@ export class BalanceService {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    error_code: error.cause ? error.cause.code : data ? data.error_code : response ? response.status : "Unknown Error Code",
+                    error_message: error.cause ? error.cause.message : data ? data.error_message : response && response.status === 500 ? "Internal server error" : !response ? "Unknown Error" : "401 Authorization Required"
                 };
             }
         }
@@ -887,6 +894,7 @@ export class BalanceService {
                 if (queryParamOpts?.blockHeight !== undefined) {
                     urlParams.append("block-height", queryParamOpts?.blockHeight.toString());
                 }
+                const url = `https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/balances_native/?${urlParams}`;
                 let startTime;
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
@@ -894,13 +902,13 @@ export class BalanceService {
                 response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/balances_native/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": userAgent
+                        "X-Requested-With": this.source ? this.source + " " + "(" + userAgent + ")" : userAgent
                     }
                 }));
-                debugOutput(response.url, response.status ?? 429, startTime);
-                if (response.status === null || response.status === 429) {
+                debugOutput(response ? response.url : url, response ? response.status : 429, startTime);
+                if ((this.enableRetry === true) && (!response || response.status === null || response.status === 429)) {
                     try {
-                        data = await this.LIMIT(() => backoff.backOff(response.url));
+                        data = await this.LIMIT(() => backoff.backOff(response ? response.url : url, this.source));
                     }
                     catch (error) {
                         success = true;
@@ -930,8 +938,8 @@ export class BalanceService {
                 return {
                     data: null,
                     error: true,
-                    error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                    error_code: error.cause ? error.cause.code : data ? data.error_code : response ? response.status : "Unknown Error Code",
+                    error_message: error.cause ? error.cause.message : data ? data.error_message : response && response.status === 500 ? "Internal server error" : !response ? "Unknown Error" : "401 Authorization Required"
                 };
             }
         }