@opensea/sdk 9.0.0

package/lib/src/api/apiPaths.d.ts

@@ -0,0 +1,37 @@
+import type { OrderProtocol } from "../orders/types";
+import { type Chain, OrderSide } from "../types";
+/** Base path prefix for all OpenSea API v2 endpoints. */
+export declare const API_V2_PREFIX = "/api/v2";
+export declare const getOrdersAPIPath: (chain: Chain, protocol: OrderProtocol, side: OrderSide) => string;
+export declare const getAllOffersAPIPath: (collectionSlug: string) => string;
+export declare const getAllListingsAPIPath: (collectionSlug: string) => string;
+export declare const getBestOfferAPIPath: (collectionSlug: string, tokenId: string | number) => string;
+export declare const getBestListingAPIPath: (collectionSlug: string, tokenId: string | number) => string;
+export declare const getBestListingsAPIPath: (collectionSlug: string) => string;
+export declare const getCollectionPath: (slug: string) => string;
+export declare const getCollectionsPath: () => string;
+export declare const getCollectionStatsPath: (slug: string) => string;
+export declare const getPaymentTokenPath: (chain: Chain, address: string) => string;
+export declare const getAccountPath: (address: string) => string;
+export declare const getBuildOfferPath: () => string;
+export declare const getPostCollectionOfferPath: () => string;
+export declare const getCollectionOffersPath: (slug: string) => string;
+export declare const getListNFTsByCollectionPath: (slug: string) => string;
+export declare const getListNFTsByContractPath: (chain: Chain, address: string) => string;
+export declare const getListNFTsByAccountPath: (chain: Chain, address: string) => string;
+export declare const getNFTPath: (chain: Chain, address: string, identifier: string) => string;
+export declare const getRefreshMetadataPath: (chain: Chain, address: string, identifier: string) => string;
+export declare const getOrderByHashPath: (chain: Chain, protocolAddress: string, orderHash: string) => string;
+export declare const getCancelOrderPath: (chain: Chain, protocolAddress: string, orderHash: string) => string;
+export declare const getTraitOffersPath: (collectionSlug: string) => string;
+export declare const getEventsAPIPath: () => string;
+export declare const getEventsByAccountAPIPath: (address: string) => string;
+export declare const getEventsByCollectionAPIPath: (collectionSlug: string) => string;
+export declare const getEventsByNFTAPIPath: (chain: Chain, address: string, identifier: string) => string;
+export declare const getContractPath: (chain: Chain, address: string) => string;
+export declare const getTraitsPath: (collectionSlug: string) => string;
+export declare const getTrendingTokensPath: () => string;
+export declare const getTopTokensPath: () => string;
+export declare const getSwapQuotePath: () => string;
+export declare const getTokenPath: (chain: string, address: string) => string;
+export declare const getSearchPath: () => string;

package/lib/src/api/apiPaths.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSearchPath = exports.getTokenPath = exports.getSwapQuotePath = exports.getTopTokensPath = exports.getTrendingTokensPath = exports.getTraitsPath = exports.getContractPath = exports.getEventsByNFTAPIPath = exports.getEventsByCollectionAPIPath = exports.getEventsByAccountAPIPath = exports.getEventsAPIPath = exports.getTraitOffersPath = exports.getCancelOrderPath = exports.getOrderByHashPath = exports.getRefreshMetadataPath = exports.getNFTPath = exports.getListNFTsByAccountPath = exports.getListNFTsByContractPath = exports.getListNFTsByCollectionPath = exports.getCollectionOffersPath = exports.getPostCollectionOfferPath = exports.getBuildOfferPath = exports.getAccountPath = exports.getPaymentTokenPath = exports.getCollectionStatsPath = exports.getCollectionsPath = exports.getCollectionPath = exports.getBestListingsAPIPath = exports.getBestListingAPIPath = exports.getBestOfferAPIPath = exports.getAllListingsAPIPath = exports.getAllOffersAPIPath = exports.getOrdersAPIPath = exports.API_V2_PREFIX = void 0;
+const types_1 = require("../types");
+/** Base path prefix for all OpenSea API v2 endpoints. */
+exports.API_V2_PREFIX = "/api/v2";
+const getOrdersAPIPath = (chain, protocol, side) => {
+    const sidePath = side === types_1.OrderSide.LISTING ? "listings" : "offers";
+    return `${exports.API_V2_PREFIX}/orders/${chain}/${protocol}/${sidePath}`;
+};
+exports.getOrdersAPIPath = getOrdersAPIPath;
+const getAllOffersAPIPath = (collectionSlug) => {
+    return `${exports.API_V2_PREFIX}/offers/collection/${collectionSlug}/all`;
+};
+exports.getAllOffersAPIPath = getAllOffersAPIPath;
+const getAllListingsAPIPath = (collectionSlug) => {
+    return `${exports.API_V2_PREFIX}/listings/collection/${collectionSlug}/all`;
+};
+exports.getAllListingsAPIPath = getAllListingsAPIPath;
+const getBestOfferAPIPath = (collectionSlug, tokenId) => {
+    return `${exports.API_V2_PREFIX}/offers/collection/${collectionSlug}/nfts/${tokenId}/best`;
+};
+exports.getBestOfferAPIPath = getBestOfferAPIPath;
+const getBestListingAPIPath = (collectionSlug, tokenId) => {
+    return `${exports.API_V2_PREFIX}/listings/collection/${collectionSlug}/nfts/${tokenId}/best`;
+};
+exports.getBestListingAPIPath = getBestListingAPIPath;
+const getBestListingsAPIPath = (collectionSlug) => {
+    return `${exports.API_V2_PREFIX}/listings/collection/${collectionSlug}/best`;
+};
+exports.getBestListingsAPIPath = getBestListingsAPIPath;
+const getCollectionPath = (slug) => {
+    return `${exports.API_V2_PREFIX}/collections/${slug}`;
+};
+exports.getCollectionPath = getCollectionPath;
+const getCollectionsPath = () => {
+    return `${exports.API_V2_PREFIX}/collections`;
+};
+exports.getCollectionsPath = getCollectionsPath;
+const getCollectionStatsPath = (slug) => {
+    return `${exports.API_V2_PREFIX}/collections/${slug}/stats`;
+};
+exports.getCollectionStatsPath = getCollectionStatsPath;
+const getPaymentTokenPath = (chain, address) => {
+    return `${exports.API_V2_PREFIX}/chain/${chain}/payment_token/${address}`;
+};
+exports.getPaymentTokenPath = getPaymentTokenPath;
+const getAccountPath = (address) => {
+    return `${exports.API_V2_PREFIX}/accounts/${address}`;
+};
+exports.getAccountPath = getAccountPath;
+const getBuildOfferPath = () => {
+    return `${exports.API_V2_PREFIX}/offers/build`;
+};
+exports.getBuildOfferPath = getBuildOfferPath;
+const getPostCollectionOfferPath = () => {
+    return `${exports.API_V2_PREFIX}/offers`;
+};
+exports.getPostCollectionOfferPath = getPostCollectionOfferPath;
+const getCollectionOffersPath = (slug) => {
+    return `${exports.API_V2_PREFIX}/offers/collection/${slug}`;
+};
+exports.getCollectionOffersPath = getCollectionOffersPath;
+const getListNFTsByCollectionPath = (slug) => {
+    return `${exports.API_V2_PREFIX}/collection/${slug}/nfts`;
+};
+exports.getListNFTsByCollectionPath = getListNFTsByCollectionPath;
+const getListNFTsByContractPath = (chain, address) => {
+    return `${exports.API_V2_PREFIX}/chain/${chain}/contract/${address}/nfts`;
+};
+exports.getListNFTsByContractPath = getListNFTsByContractPath;
+const getListNFTsByAccountPath = (chain, address) => {
+    return `${exports.API_V2_PREFIX}/chain/${chain}/account/${address}/nfts`;
+};
+exports.getListNFTsByAccountPath = getListNFTsByAccountPath;
+const getNFTPath = (chain, address, identifier) => {
+    return `${exports.API_V2_PREFIX}/chain/${chain}/contract/${address}/nfts/${identifier}`;
+};
+exports.getNFTPath = getNFTPath;
+const getRefreshMetadataPath = (chain, address, identifier) => {
+    return `${exports.API_V2_PREFIX}/chain/${chain}/contract/${address}/nfts/${identifier}/refresh`;
+};
+exports.getRefreshMetadataPath = getRefreshMetadataPath;
+const getOrderByHashPath = (chain, protocolAddress, orderHash) => {
+    return `${exports.API_V2_PREFIX}/orders/chain/${chain}/protocol/${protocolAddress}/${orderHash}`;
+};
+exports.getOrderByHashPath = getOrderByHashPath;
+const getCancelOrderPath = (chain, protocolAddress, orderHash) => {
+    return `${exports.API_V2_PREFIX}/orders/chain/${chain}/protocol/${protocolAddress}/${orderHash}/cancel`;
+};
+exports.getCancelOrderPath = getCancelOrderPath;
+const getTraitOffersPath = (collectionSlug) => {
+    return `${exports.API_V2_PREFIX}/offers/collection/${collectionSlug}/traits`;
+};
+exports.getTraitOffersPath = getTraitOffersPath;
+const getEventsAPIPath = () => {
+    return `${exports.API_V2_PREFIX}/events`;
+};
+exports.getEventsAPIPath = getEventsAPIPath;
+const getEventsByAccountAPIPath = (address) => {
+    return `${exports.API_V2_PREFIX}/events/accounts/${address}`;
+};
+exports.getEventsByAccountAPIPath = getEventsByAccountAPIPath;
+const getEventsByCollectionAPIPath = (collectionSlug) => {
+    return `${exports.API_V2_PREFIX}/events/collection/${collectionSlug}`;
+};
+exports.getEventsByCollectionAPIPath = getEventsByCollectionAPIPath;
+const getEventsByNFTAPIPath = (chain, address, identifier) => {
+    return `${exports.API_V2_PREFIX}/events/chain/${chain}/contract/${address}/nfts/${identifier}`;
+};
+exports.getEventsByNFTAPIPath = getEventsByNFTAPIPath;
+const getContractPath = (chain, address) => {
+    return `${exports.API_V2_PREFIX}/chain/${chain}/contract/${address}`;
+};
+exports.getContractPath = getContractPath;
+const getTraitsPath = (collectionSlug) => {
+    return `${exports.API_V2_PREFIX}/traits/${collectionSlug}`;
+};
+exports.getTraitsPath = getTraitsPath;
+const getTrendingTokensPath = () => {
+    return `${exports.API_V2_PREFIX}/tokens/trending`;
+};
+exports.getTrendingTokensPath = getTrendingTokensPath;
+const getTopTokensPath = () => {
+    return `${exports.API_V2_PREFIX}/tokens/top`;
+};
+exports.getTopTokensPath = getTopTokensPath;
+const getSwapQuotePath = () => {
+    return `${exports.API_V2_PREFIX}/swap/quote`;
+};
+exports.getSwapQuotePath = getSwapQuotePath;
+const getTokenPath = (chain, address) => {
+    return `${exports.API_V2_PREFIX}/chain/${chain}/token/${address}`;
+};
+exports.getTokenPath = getTokenPath;
+const getSearchPath = () => {
+    return `${exports.API_V2_PREFIX}/search`;
+};
+exports.getSearchPath = getSearchPath;
+//# sourceMappingURL=apiPaths.js.map

package/lib/src/api/apiPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiPaths.js","sourceRoot":"","sources":["../../../src/api/apiPaths.ts"],"names":[],"mappings":"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"}

package/lib/src/api/collections.d.ts

@@ -0,0 +1,26 @@
+import type { Chain, OpenSeaCollection, OpenSeaCollectionStats } from "../types";
+import type { Fetcher } from "./fetcher";
+import { CollectionOrderByOption, type GetCollectionsResponse, type GetTraitsResponse } from "./types";
+/**
+ * Collection-related API operations
+ */
+export declare class CollectionsAPI {
+    private fetcher;
+    constructor(fetcher: Fetcher);
+    /**
+     * Fetch an OpenSea collection.
+     */
+    getCollection(slug: string): Promise<OpenSeaCollection>;
+    /**
+     * Fetch a list of OpenSea collections.
+     */
+    getCollections(orderBy?: CollectionOrderByOption, chain?: Chain, creatorUsername?: string, includeHidden?: boolean, limit?: number, next?: string): Promise<GetCollectionsResponse>;
+    /**
+     * Fetch stats for an OpenSea collection.
+     */
+    getCollectionStats(slug: string): Promise<OpenSeaCollectionStats>;
+    /**
+     * Fetch all traits for a collection with their possible values and counts.
+     */
+    getTraits(collectionSlug: string): Promise<GetTraitsResponse>;
+}

package/lib/src/api/collections.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionsAPI = void 0;
+const converters_1 = require("../utils/converters");
+const apiPaths_1 = require("./apiPaths");
+const types_1 = require("./types");
+/**
+ * Collection-related API operations
+ */
+class CollectionsAPI {
+    constructor(fetcher) {
+        this.fetcher = fetcher;
+    }
+    /**
+     * Fetch an OpenSea collection.
+     */
+    async getCollection(slug) {
+        const path = (0, apiPaths_1.getCollectionPath)(slug);
+        const response = await this.fetcher.get(path);
+        return (0, converters_1.collectionFromJSON)(response);
+    }
+    /**
+     * Fetch a list of OpenSea collections.
+     */
+    async getCollections(orderBy = types_1.CollectionOrderByOption.CREATED_DATE, chain, creatorUsername, includeHidden = false, limit, next) {
+        const path = (0, apiPaths_1.getCollectionsPath)();
+        const args = {
+            order_by: orderBy,
+            chain,
+            creator_username: creatorUsername,
+            include_hidden: includeHidden,
+            limit,
+            next,
+        };
+        const response = await this.fetcher.get(path, args);
+        response.collections = response.collections.map(collection => (0, converters_1.collectionFromJSON)(collection));
+        return response;
+    }
+    /**
+     * Fetch stats for an OpenSea collection.
+     */
+    async getCollectionStats(slug) {
+        const path = (0, apiPaths_1.getCollectionStatsPath)(slug);
+        const response = await this.fetcher.get(path);
+        return response;
+    }
+    /**
+     * Fetch all traits for a collection with their possible values and counts.
+     */
+    async getTraits(collectionSlug) {
+        const path = (0, apiPaths_1.getTraitsPath)(collectionSlug);
+        const response = await this.fetcher.get(path);
+        return response;
+    }
+}
+exports.CollectionsAPI = CollectionsAPI;
+//# sourceMappingURL=collections.js.map

package/lib/src/api/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../../src/api/collections.ts"],"names":[],"mappings":";;;AACA,oDAAwD;AACxD,yCAKmB;AAEnB,mCAMgB;AAEhB;;GAEG;AACH,MAAa,cAAc;IACzB,YAAoB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAExC;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,IAAY;QAC9B,MAAM,IAAI,GAAG,IAAA,4BAAiB,EAAC,IAAI,CAAC,CAAA;QACpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAwB,IAAI,CAAC,CAAA;QACpE,OAAO,IAAA,+BAAkB,EAAC,QAAQ,CAAC,CAAA;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,UAAmC,+BAAuB,CAAC,YAAY,EACvE,KAAa,EACb,eAAwB,EACxB,gBAAyB,KAAK,EAC9B,KAAc,EACd,IAAa;QAEb,MAAM,IAAI,GAAG,IAAA,6BAAkB,GAAE,CAAA;QACjC,MAAM,IAAI,GAAuB;YAC/B,QAAQ,EAAE,OAAO;YACjB,KAAK;YACL,gBAAgB,EAAE,eAAe;YACjC,cAAc,EAAE,aAAa;YAC7B,KAAK;YACL,IAAI;SACL,CAAA;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAyB,IAAI,EAAE,IAAI,CAAC,CAAA;QAC3E,QAAQ,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAC3D,IAAA,+BAAkB,EAAC,UAAU,CAAC,CAC/B,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,IAAY;QACnC,MAAM,IAAI,GAAG,IAAA,iCAAsB,EAAC,IAAI,CAAC,CAAA;QACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAyB,IAAI,CAAC,CAAA;QACrE,OAAO,QAAkC,CAAA;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,cAAsB;QACpC,MAAM,IAAI,GAAG,IAAA,wBAAa,EAAC,cAAc,CAAC,CAAA;QAC1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAoB,IAAI,CAAC,CAAA;QAChE,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF;AAxDD,wCAwDC"}

package/lib/src/api/events.d.ts

@@ -0,0 +1,26 @@
+import type { Chain } from "../types";
+import type { Fetcher } from "./fetcher";
+import type { GetEventsArgs, GetEventsResponse } from "./types";
+/**
+ * Events-related API operations
+ */
+export declare class EventsAPI {
+    private fetcher;
+    constructor(fetcher: Fetcher);
+    /**
+     * Gets a list of events based on query parameters.
+     */
+    getEvents(args?: GetEventsArgs): Promise<GetEventsResponse>;
+    /**
+     * Gets a list of events for a specific account.
+     */
+    getEventsByAccount(address: string, args?: GetEventsArgs): Promise<GetEventsResponse>;
+    /**
+     * Gets a list of events for a specific collection.
+     */
+    getEventsByCollection(collectionSlug: string, args?: GetEventsArgs): Promise<GetEventsResponse>;
+    /**
+     * Gets a list of events for a specific NFT.
+     */
+    getEventsByNFT(chain: Chain, address: string, identifier: string, args?: GetEventsArgs): Promise<GetEventsResponse>;
+}

package/lib/src/api/events.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventsAPI = void 0;
+const apiPaths_1 = require("./apiPaths");
+/**
+ * Events-related API operations
+ */
+class EventsAPI {
+    constructor(fetcher) {
+        this.fetcher = fetcher;
+    }
+    /**
+     * Gets a list of events based on query parameters.
+     */
+    async getEvents(args) {
+        const response = await this.fetcher.get((0, apiPaths_1.getEventsAPIPath)(), args);
+        return response;
+    }
+    /**
+     * Gets a list of events for a specific account.
+     */
+    async getEventsByAccount(address, args) {
+        const response = await this.fetcher.get((0, apiPaths_1.getEventsByAccountAPIPath)(address), args);
+        return response;
+    }
+    /**
+     * Gets a list of events for a specific collection.
+     */
+    async getEventsByCollection(collectionSlug, args) {
+        const response = await this.fetcher.get((0, apiPaths_1.getEventsByCollectionAPIPath)(collectionSlug), args);
+        return response;
+    }
+    /**
+     * Gets a list of events for a specific NFT.
+     */
+    async getEventsByNFT(chain, address, identifier, args) {
+        const response = await this.fetcher.get((0, apiPaths_1.getEventsByNFTAPIPath)(chain, address, identifier), args);
+        return response;
+    }
+}
+exports.EventsAPI = EventsAPI;
+//# sourceMappingURL=events.js.map

package/lib/src/api/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/api/events.ts"],"names":[],"mappings":";;;AACA,yCAKmB;AAInB;;GAEG;AACH,MAAa,SAAS;IACpB,YAAoB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAExC;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,IAAoB;QAClC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,2BAAgB,GAAE,EAClB,IAAI,CACL,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACtB,OAAe,EACf,IAAoB;QAEpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,oCAAyB,EAAC,OAAO,CAAC,EAClC,IAAI,CACL,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CACzB,cAAsB,EACtB,IAAoB;QAEpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,uCAA4B,EAAC,cAAc,CAAC,EAC5C,IAAI,CACL,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,KAAY,EACZ,OAAe,EACf,UAAkB,EAClB,IAAoB;QAEpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,gCAAqB,EAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EACjD,IAAI,CACL,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF;AAzDD,8BAyDC"}

package/lib/src/api/fetcher.d.ts

@@ -0,0 +1,24 @@
+import type { RequestOptions } from "../types";
+/**
+ * Fetcher context interface for making HTTP requests to the OpenSea API.
+ * This interface abstracts the HTTP methods used by specialized API clients.
+ */
+export interface Fetcher {
+    /**
+     * Generic fetch method for GET requests with automatic rate limit retry
+     * @param apiPath Path to URL endpoint under API
+     * @param query URL query params. Will be used to create a URLSearchParams object.
+     * @param options Request options like timeout and abort signal.
+     * @returns The response from the API.
+     */
+    get<T>(apiPath: string, query?: object, options?: RequestOptions): Promise<T>;
+    /**
+     * Generic post method for POST requests with automatic rate limit retry
+     * @param apiPath Path to URL endpoint under API
+     * @param body Data to send.
+     * @param headers Additional headers to send with the request.
+     * @param options Request options like timeout and abort signal.
+     * @returns The response from the API.
+     */
+    post<T>(apiPath: string, body?: object, headers?: object, options?: RequestOptions): Promise<T>;
+}

package/lib/src/api/fetcher.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=fetcher.js.map

package/lib/src/api/fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.js","sourceRoot":"","sources":["../../../src/api/fetcher.ts"],"names":[],"mappings":""}

package/lib/src/api/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./api";
+export * from "./fetcher";

package/lib/src/api/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./api"), exports);
+__exportStar(require("./fetcher"), exports);
+//# sourceMappingURL=index.js.map

package/lib/src/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAqB;AACrB,4CAAyB"}

package/lib/src/api/listings.d.ts

@@ -0,0 +1,44 @@
+import { type Chain } from "../types";
+import type { Fetcher } from "./fetcher";
+import type { GetBestListingResponse, GetListingsResponse } from "./types";
+/**
+ * Listing-related API operations
+ */
+export declare class ListingsAPI {
+    private fetcher;
+    private chain;
+    constructor(fetcher: Fetcher, chain: Chain);
+    /**
+     * Gets all listings for a given collection.
+     * @param collectionSlug The collection slug
+     * @param limit The number of listings to return
+     * @param next The cursor for pagination
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    getAllListings(collectionSlug: string, limit?: number, next?: string, includePrivateListings?: boolean): Promise<GetListingsResponse>;
+    /**
+     * Gets the best listing for a given token.
+     * @param collectionSlug The collection slug
+     * @param tokenId The token ID
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    getBestListing(collectionSlug: string, tokenId: string | number, includePrivateListings?: boolean): Promise<GetBestListingResponse>;
+    /**
+     * Gets the best listings for a given collection.
+     * @param collectionSlug The collection slug
+     * @param limit The number of listings to return
+     * @param next The cursor for pagination
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    getBestListings(collectionSlug: string, limit?: number, next?: string, includePrivateListings?: boolean): Promise<GetListingsResponse>;
+    /**
+     * Gets all active listings for a specific NFT.
+     * @param assetContractAddress The NFT contract address
+     * @param tokenId The token ID
+     * @param limit The number of listings to return
+     * @param next The cursor for pagination
+     * @param chain The blockchain chain
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    getNFTListings(assetContractAddress: string, tokenId: string, limit?: number, next?: string, chain?: Chain, includePrivateListings?: boolean): Promise<GetListingsResponse>;
+}

package/lib/src/api/listings.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListingsAPI = void 0;
+const utils_1 = require("../orders/utils");
+const types_1 = require("../types");
+const apiPaths_1 = require("./apiPaths");
+/**
+ * Listing-related API operations
+ */
+class ListingsAPI {
+    constructor(fetcher, chain) {
+        this.fetcher = fetcher;
+        this.chain = chain;
+    }
+    /**
+     * Gets all listings for a given collection.
+     * @param collectionSlug The collection slug
+     * @param limit The number of listings to return
+     * @param next The cursor for pagination
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    async getAllListings(collectionSlug, limit, next, includePrivateListings) {
+        const response = await this.fetcher.get((0, apiPaths_1.getAllListingsAPIPath)(collectionSlug), {
+            limit,
+            next,
+            ...(includePrivateListings !== undefined && {
+                include_private_listings: includePrivateListings,
+            }),
+        });
+        return response;
+    }
+    /**
+     * Gets the best listing for a given token.
+     * @param collectionSlug The collection slug
+     * @param tokenId The token ID
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    async getBestListing(collectionSlug, tokenId, includePrivateListings) {
+        const response = await this.fetcher.get((0, apiPaths_1.getBestListingAPIPath)(collectionSlug, tokenId), includePrivateListings !== undefined
+            ? { include_private_listings: includePrivateListings }
+            : undefined);
+        return response;
+    }
+    /**
+     * Gets the best listings for a given collection.
+     * @param collectionSlug The collection slug
+     * @param limit The number of listings to return
+     * @param next The cursor for pagination
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    async getBestListings(collectionSlug, limit, next, includePrivateListings) {
+        const response = await this.fetcher.get((0, apiPaths_1.getBestListingsAPIPath)(collectionSlug), {
+            limit,
+            next,
+            ...(includePrivateListings !== undefined && {
+                include_private_listings: includePrivateListings,
+            }),
+        });
+        return response;
+    }
+    /**
+     * Gets all active listings for a specific NFT.
+     * @param assetContractAddress The NFT contract address
+     * @param tokenId The token ID
+     * @param limit The number of listings to return
+     * @param next The cursor for pagination
+     * @param chain The blockchain chain
+     * @param includePrivateListings Whether to include private listings (default: false)
+     */
+    async getNFTListings(assetContractAddress, tokenId, limit, next, chain = this.chain, includePrivateListings) {
+        const response = await this.fetcher.get((0, apiPaths_1.getOrdersAPIPath)(chain, "seaport", types_1.OrderSide.LISTING), {
+            ...(0, utils_1.serializeOrdersQueryOptions)({
+                assetContractAddress,
+                tokenIds: [tokenId],
+                limit,
+                next,
+            }),
+            ...(includePrivateListings !== undefined && {
+                include_private_listings: includePrivateListings,
+            }),
+        });
+        return response;
+    }
+}
+exports.ListingsAPI = ListingsAPI;
+//# sourceMappingURL=listings.js.map

package/lib/src/api/listings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listings.js","sourceRoot":"","sources":["../../../src/api/listings.ts"],"names":[],"mappings":";;;AAAA,2CAA6D;AAC7D,oCAAgD;AAChD,yCAKmB;AAInB;;GAEG;AACH,MAAa,WAAW;IACtB,YACU,OAAgB,EAChB,KAAY;QADZ,YAAO,GAAP,OAAO,CAAS;QAChB,UAAK,GAAL,KAAK,CAAO;IACnB,CAAC;IAEJ;;;;;;OAMG;IACH,KAAK,CAAC,cAAc,CAClB,cAAsB,EACtB,KAAc,EACd,IAAa,EACb,sBAAgC;QAEhC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,gCAAqB,EAAC,cAAc,CAAC,EACrC;YACE,KAAK;YACL,IAAI;YACJ,GAAG,CAAC,sBAAsB,KAAK,SAAS,IAAI;gBAC1C,wBAAwB,EAAE,sBAAsB;aACjD,CAAC;SACH,CACF,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAClB,cAAsB,EACtB,OAAwB,EACxB,sBAAgC;QAEhC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,gCAAqB,EAAC,cAAc,EAAE,OAAO,CAAC,EAC9C,sBAAsB,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE,wBAAwB,EAAE,sBAAsB,EAAE;YACtD,CAAC,CAAC,SAAS,CACd,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CACnB,cAAsB,EACtB,KAAc,EACd,IAAa,EACb,sBAAgC;QAEhC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,iCAAsB,EAAC,cAAc,CAAC,EACtC;YACE,KAAK;YACL,IAAI;YACJ,GAAG,CAAC,sBAAsB,KAAK,SAAS,IAAI;gBAC1C,wBAAwB,EAAE,sBAAsB;aACjD,CAAC;SACH,CACF,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,cAAc,CAClB,oBAA4B,EAC5B,OAAe,EACf,KAAc,EACd,IAAa,EACb,QAAe,IAAI,CAAC,KAAK,EACzB,sBAAgC;QAEhC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACrC,IAAA,2BAAgB,EAAC,KAAK,EAAE,SAAS,EAAE,iBAAS,CAAC,OAAO,CAAC,EACrD;YACE,GAAG,IAAA,mCAA2B,EAAC;gBAC7B,oBAAoB;gBACpB,QAAQ,EAAE,CAAC,OAAO,CAAC;gBACnB,KAAK;gBACL,IAAI;aACL,CAAC;YACF,GAAG,CAAC,sBAAsB,KAAK,SAAS,IAAI;gBAC1C,wBAAwB,EAAE,sBAAsB;aACjD,CAAC;SACH,CACF,CAAA;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF;AA/GD,kCA+GC"}

package/lib/src/api/nfts.d.ts

@@ -0,0 +1,35 @@
+import type { Chain } from "../types";
+import type { Fetcher } from "./fetcher";
+import type { GetContractResponse, GetNFTResponse, ListNFTsResponse } from "./types";
+/**
+ * NFT-related API operations
+ */
+export declare class NFTsAPI {
+    private fetcher;
+    private chain;
+    constructor(fetcher: Fetcher, chain: Chain);
+    /**
+     * Fetch multiple NFTs for a collection.
+     */
+    getNFTsByCollection(slug: string, limit?: number | undefined, next?: string | undefined): Promise<ListNFTsResponse>;
+    /**
+     * Fetch multiple NFTs for a contract.
+     */
+    getNFTsByContract(address: string, limit?: number | undefined, next?: string | undefined, chain?: Chain): Promise<ListNFTsResponse>;
+    /**
+     * Fetch NFTs owned by an account.
+     */
+    getNFTsByAccount(address: string, limit?: number | undefined, next?: string | undefined, chain?: Chain): Promise<ListNFTsResponse>;
+    /**
+     * Fetch metadata, traits, ownership information, and rarity for a single NFT.
+     */
+    getNFT(address: string, identifier: string, chain?: Chain): Promise<GetNFTResponse>;
+    /**
+     * Force refresh the metadata for an NFT.
+     */
+    refreshNFTMetadata(address: string, identifier: string, chain?: Chain): Promise<Response>;
+    /**
+     * Fetch smart contract information for a given chain and address.
+     */
+    getContract(address: string, chain?: Chain): Promise<GetContractResponse>;
+}

package/lib/src/api/nfts.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NFTsAPI = void 0;
+const apiPaths_1 = require("./apiPaths");
+/**
+ * NFT-related API operations
+ */
+class NFTsAPI {
+    constructor(fetcher, chain) {
+        this.fetcher = fetcher;
+        this.chain = chain;
+    }
+    /**
+     * Fetch multiple NFTs for a collection.
+     */
+    async getNFTsByCollection(slug, limit = undefined, next = undefined) {
+        const response = await this.fetcher.get((0, apiPaths_1.getListNFTsByCollectionPath)(slug), {
+            limit,
+            next,
+        });
+        return response;
+    }
+    /**
+     * Fetch multiple NFTs for a contract.
+     */
+    async getNFTsByContract(address, limit = undefined, next = undefined, chain = this.chain) {
+        const response = await this.fetcher.get((0, apiPaths_1.getListNFTsByContractPath)(chain, address), {
+            limit,
+            next,
+        });
+        return response;
+    }
+    /**
+     * Fetch NFTs owned by an account.
+     */
+    async getNFTsByAccount(address, limit = undefined, next = undefined, chain = this.chain) {
+        const response = await this.fetcher.get((0, apiPaths_1.getListNFTsByAccountPath)(chain, address), {
+            limit,
+            next,
+        });
+        return response;
+    }
+    /**
+     * Fetch metadata, traits, ownership information, and rarity for a single NFT.
+     */
+    async getNFT(address, identifier, chain = this.chain) {
+        const response = await this.fetcher.get((0, apiPaths_1.getNFTPath)(chain, address, identifier));
+        return response;
+    }
+    /**
+     * Force refresh the metadata for an NFT.
+     */
+    async refreshNFTMetadata(address, identifier, chain = this.chain) {
+        const response = await this.fetcher.post((0, apiPaths_1.getRefreshMetadataPath)(chain, address, identifier), {});
+        return response;
+    }
+    /**
+     * Fetch smart contract information for a given chain and address.
+     */
+    async getContract(address, chain = this.chain) {
+        const response = await this.fetcher.get((0, apiPaths_1.getContractPath)(chain, address));
+        return response;
+    }
+}
+exports.NFTsAPI = NFTsAPI;
+//# sourceMappingURL=nfts.js.map