@upbit-official/upbit-sdk 0.9.0

package/lib/ws.mjs

@@ -0,0 +1,223 @@
+import * as WS from 'ws';
+import { uuid4 } from "../internal/utils/uuid.mjs";
+import { createJwtToken } from "./jwtAuth.mjs";
+import { jsonParseFloat } from "./jsonParseFloat.mjs";
+import { buildURL as buildPublicURL } from "../resources/ws-public/internal-base.mjs";
+import { buildURL as buildPrivateURL } from "../resources/ws-private/internal-base.mjs";
+function buildSubscriptionMessage(types) {
+    const fields = [{ ticket: uuid4() }];
+    for (const t of types) {
+        if ('codes' in t && t.codes) {
+            fields.push({ type: t.type, codes: t.codes });
+        }
+        else {
+            fields.push({ type: t.type });
+        }
+    }
+    return JSON.stringify(fields);
+}
+/**
+ * Manages a WebSocket stream as an AsyncIterable.
+ *
+ * Use with `for await (const event of manager) { ... }`.
+ */
+export class WsStreamManager {
+    constructor(client, types, isPrivate, opts = {}) {
+        this._currentWs = null;
+        this.client = client;
+        this.types = types;
+        this.isPrivate = isPrivate;
+        this.maxRetries = opts.maxRetries ?? 5;
+        this.retryDelayMs = opts.retryDelayMs ?? 1000;
+        if (opts.onDisconnect)
+            this.onDisconnect = opts.onDisconnect;
+        if (opts.onReconnect)
+            this.onReconnect = opts.onReconnect;
+    }
+    /** Closes the current WebSocket connection. */
+    close() {
+        if (this._currentWs &&
+            (this._currentWs.readyState === WS.WebSocket.OPEN ||
+                this._currentWs.readyState === WS.WebSocket.CONNECTING)) {
+            this._currentWs.close(1000, 'close() called');
+        }
+    }
+    [Symbol.asyncIterator]() {
+        return this._iterate();
+    }
+    async *_iterate() {
+        let retries = 0;
+        while (true) {
+            const queue = [];
+            let resolve = null;
+            let reject = null;
+            let done = false;
+            let closeCode = 1000;
+            let closeReason = '';
+            const ws = await this._connect();
+            this._currentWs = ws;
+            ws.on('message', (data) => {
+                try {
+                    const parsed = jsonParseFloat(data.toString());
+                    queue.push(parsed);
+                    resolve?.();
+                    resolve = null;
+                }
+                catch {
+                    // ignore JSON parse errors
+                }
+            });
+            ws.on('close', (code, reason) => {
+                done = true;
+                closeCode = code;
+                closeReason = reason.toString();
+                resolve?.();
+                resolve = null;
+            });
+            ws.on('error', (err) => {
+                done = true;
+                reject?.(err);
+                reject = null;
+                resolve?.();
+                resolve = null;
+            });
+            try {
+                while (!done || queue.length > 0) {
+                    if (queue.length === 0) {
+                        await new Promise((res, rej) => {
+                            resolve = res;
+                            reject = rej;
+                        });
+                    }
+                    while (queue.length > 0) {
+                        yield queue.shift();
+                    }
+                }
+            }
+            finally {
+                this._currentWs = null;
+                if (ws.readyState === WS.WebSocket.OPEN || ws.readyState === WS.WebSocket.CONNECTING) {
+                    ws.close();
+                }
+            }
+            // normal close (1000, 1001) — end the stream
+            if (closeCode === 1000 || closeCode === 1001) {
+                this.onDisconnect?.(closeCode, closeReason);
+                return;
+            }
+            // attempt reconnect
+            this.onDisconnect?.(closeCode, closeReason);
+            if (retries >= this.maxRetries) {
+                throw new Error(`WebSocket disconnected (code=${closeCode}, reason=${closeReason}) after ${retries} retries`);
+            }
+            retries++;
+            await new Promise((r) => setTimeout(r, this.retryDelayMs));
+            this.onReconnect?.();
+        }
+    }
+    async _connect() {
+        const url = this.isPrivate ? buildPrivateURL(this.client) : buildPublicURL(this.client);
+        const headers = {};
+        if (this.isPrivate) {
+            const { accessKey, secretKey } = this.client;
+            if (!accessKey || !secretKey) {
+                throw new Error('Private WebSocket requires accessKey and secretKey');
+            }
+            const token = createJwtToken(accessKey, secretKey);
+            headers['Authorization'] = `Bearer ${token}`;
+        }
+        return new Promise((resolve, reject) => {
+            const ws = new WS.WebSocket(url.toString(), { headers });
+            const onOpen = () => {
+                ws.removeListener('error', onError);
+                ws.send(buildSubscriptionMessage(this.types));
+                resolve(ws);
+            };
+            const onError = (err) => {
+                ws.removeListener('open', onOpen);
+                reject(err);
+            };
+            ws.once('open', onOpen);
+            ws.once('error', onError);
+        });
+    }
+}
+/**
+ * Convenience API for WebSocket streams.
+ *
+ * Start a stream with `client.wsStream.ticker(['KRW-BTC'])` and
+ * receive events using `for await (const event of ...)`.
+ */
+export class WsStream {
+    constructor(client) {
+        this.client = client;
+    }
+    /** Subscribe to the ticker (current price) stream. */
+    ticker(codes, opts) {
+        return new WsStreamManager(this.client, [{ type: 'ticker', codes }], false, opts);
+    }
+    /** Subscribe to the trade (executed order) stream. */
+    trade(codes, opts) {
+        return new WsStreamManager(this.client, [{ type: 'trade', codes }], false, opts);
+    }
+    /** Subscribe to the orderbook stream. */
+    orderbook(codes, opts) {
+        return new WsStreamManager(this.client, [{ type: 'orderbook', codes }], false, opts);
+    }
+    /** Subscribe to the candle stream. */
+    candle(codes, opts) {
+        const { interval = '1m', ...streamOpts } = opts ?? {};
+        return new WsStreamManager(this.client, [{ type: `candle.${interval}`, codes }], false, streamOpts);
+    }
+    /** Subscribe to the myOrder (my orders) stream. Requires authentication. */
+    myOrder(codes, opts) {
+        return new WsStreamManager(this.client, [{ type: 'myOrder', codes }], true, opts);
+    }
+    /** Subscribe to the myAsset (my assets) stream. Requires authentication. */
+    myAsset(opts) {
+        return new WsStreamManager(this.client, [{ type: 'myAsset' }], true, opts);
+    }
+    /** Subscribe to multiple public streams at once. */
+    subscribe(opts) {
+        const { ticker, trade, orderbook, candle, maxRetries, retryDelayMs, onDisconnect, onReconnect } = opts;
+        const types = [];
+        if (ticker)
+            types.push({ type: 'ticker', codes: ticker });
+        if (trade)
+            types.push({ type: 'trade', codes: trade });
+        if (orderbook)
+            types.push({ type: 'orderbook', codes: orderbook });
+        if (candle)
+            types.push({ type: `candle.${candle.interval ?? '1m'}`, codes: candle.codes });
+        const streamOpts = {};
+        if (maxRetries !== undefined)
+            streamOpts.maxRetries = maxRetries;
+        if (retryDelayMs !== undefined)
+            streamOpts.retryDelayMs = retryDelayMs;
+        if (onDisconnect)
+            streamOpts.onDisconnect = onDisconnect;
+        if (onReconnect)
+            streamOpts.onReconnect = onReconnect;
+        return new WsStreamManager(this.client, types, false, streamOpts);
+    }
+    /** Subscribe to multiple private streams at once. Requires authentication. */
+    subscribePrivate(opts) {
+        const { myOrder, myAsset, maxRetries, retryDelayMs, onDisconnect, onReconnect } = opts;
+        const types = [];
+        if (myOrder)
+            types.push({ type: 'myOrder', codes: myOrder });
+        if (myAsset)
+            types.push({ type: 'myAsset' });
+        const streamOpts = {};
+        if (maxRetries !== undefined)
+            streamOpts.maxRetries = maxRetries;
+        if (retryDelayMs !== undefined)
+            streamOpts.retryDelayMs = retryDelayMs;
+        if (onDisconnect)
+            streamOpts.onDisconnect = onDisconnect;
+        if (onReconnect)
+            streamOpts.onReconnect = onReconnect;
+        return new WsStreamManager(this.client, types, true, streamOpts);
+    }
+}
+//# sourceMappingURL=ws.mjs.map

package/lib/ws.mjs.map

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

package/package.json

@@ -0,0 +1,169 @@
+{
+  "name": "@upbit-official/upbit-sdk",
+  "version": "0.9.0",
+  "description": "The official TypeScript library for the Upbit API",
+  "author": "Upbit <open-api@upbit.com>",
+  "types": "./index.d.ts",
+  "main": "./index.js",
+  "type": "commonjs",
+  "repository": "github:upbit-official/upbit-sdk-typescript",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "files": [
+    "**/*"
+  ],
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "ws": "^8.18.0"
+  },
+  "overrides": {
+    "minimatch": "^9.0.5"
+  },
+  "resolutions": {
+    "minimatch": "^9.0.5"
+  },
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      },
+      "types": "./index.d.mts",
+      "default": "./index.mjs"
+    },
+    "./api-promise": {
+      "import": "./api-promise.mjs",
+      "require": "./api-promise.js"
+    },
+    "./api-promise.js": {
+      "default": "./api-promise.js"
+    },
+    "./api-promise.mjs": {
+      "default": "./api-promise.mjs"
+    },
+    "./client": {
+      "import": "./client.mjs",
+      "require": "./client.js"
+    },
+    "./client.js": {
+      "default": "./client.js"
+    },
+    "./client.mjs": {
+      "default": "./client.mjs"
+    },
+    "./core/*.mjs": {
+      "default": "./core/*.mjs"
+    },
+    "./core/*.js": {
+      "default": "./core/*.js"
+    },
+    "./core/*": {
+      "import": "./core/*.mjs",
+      "require": "./core/*.js"
+    },
+    "./error": {
+      "import": "./error.mjs",
+      "require": "./error.js"
+    },
+    "./error.js": {
+      "default": "./error.js"
+    },
+    "./error.mjs": {
+      "default": "./error.mjs"
+    },
+    "./index": {
+      "import": "./index.mjs",
+      "require": "./index.js"
+    },
+    "./index.js": {
+      "default": "./index.js"
+    },
+    "./index.mjs": {
+      "default": "./index.mjs"
+    },
+    "./lib/*.mjs": {
+      "default": "./lib/*.mjs"
+    },
+    "./lib/*.js": {
+      "default": "./lib/*.js"
+    },
+    "./lib/*": {
+      "import": "./lib/*.mjs",
+      "require": "./lib/*.js"
+    },
+    "./pagination": {
+      "import": "./pagination.mjs",
+      "require": "./pagination.js"
+    },
+    "./pagination.js": {
+      "default": "./pagination.js"
+    },
+    "./pagination.mjs": {
+      "default": "./pagination.mjs"
+    },
+    "./resource": {
+      "import": "./resource.mjs",
+      "require": "./resource.js"
+    },
+    "./resource.js": {
+      "default": "./resource.js"
+    },
+    "./resource.mjs": {
+      "default": "./resource.mjs"
+    },
+    "./resources/*.mjs": {
+      "default": "./resources/*.mjs"
+    },
+    "./resources/*.js": {
+      "default": "./resources/*.js"
+    },
+    "./resources/*": {
+      "import": "./resources/*.mjs",
+      "require": "./resources/*.js"
+    },
+    "./resources": {
+      "import": "./resources.mjs",
+      "require": "./resources.js"
+    },
+    "./resources.js": {
+      "default": "./resources.js"
+    },
+    "./resources.mjs": {
+      "default": "./resources.mjs"
+    },
+    "./uploads": {
+      "import": "./uploads.mjs",
+      "require": "./uploads.js"
+    },
+    "./uploads.js": {
+      "default": "./uploads.js"
+    },
+    "./uploads.mjs": {
+      "default": "./uploads.mjs"
+    },
+    "./version": {
+      "import": "./version.mjs",
+      "require": "./version.js"
+    },
+    "./version.js": {
+      "default": "./version.js"
+    },
+    "./version.mjs": {
+      "default": "./version.mjs"
+    }
+  },
+  "scripts": {
+    "test": "./scripts/test",
+    "build": "./scripts/build",
+    "format": "./scripts/format",
+    "tsn": "ts-node -r tsconfig-paths/register",
+    "lint": "./scripts/lint",
+    "fix": "./scripts/format"
+  }
+}

package/pagination.d.mts

@@ -0,0 +1,2 @@
+export * from "./core/pagination.mjs";
+//# sourceMappingURL=pagination.d.mts.map

package/pagination.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.mts","sourceRoot":"","sources":["src/pagination.ts"],"names":[],"mappings":""}

package/pagination.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/pagination.js";
+//# sourceMappingURL=pagination.d.ts.map

package/pagination.d.ts.map

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

package/pagination.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./internal/tslib.js");
+/** @deprecated Import from ./core/pagination instead */
+tslib_1.__exportStar(require("./core/pagination.js"), exports);
+//# sourceMappingURL=pagination.js.map

package/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["src/pagination.ts"],"names":[],"mappings":";;;AAAA,wDAAwD;AACxD,+DAAkC"}

package/pagination.mjs

@@ -0,0 +1,2 @@
+export * from "./core/pagination.mjs";
+//# sourceMappingURL=pagination.mjs.map

package/pagination.mjs.map

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

package/resource.d.mts

@@ -0,0 +1,2 @@
+export * from "./core/resource.mjs";
+//# sourceMappingURL=resource.d.mts.map

package/resource.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.mts","sourceRoot":"","sources":["src/resource.ts"],"names":[],"mappings":""}

package/resource.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/resource.js";
+//# sourceMappingURL=resource.d.ts.map

package/resource.d.ts.map

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

package/resource.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./internal/tslib.js");
+/** @deprecated Import from ./core/resource instead */
+tslib_1.__exportStar(require("./core/resource.js"), exports);
+//# sourceMappingURL=resource.js.map

package/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["src/resource.ts"],"names":[],"mappings":";;;AAAA,sDAAsD;AACtD,6DAAgC"}

package/resource.mjs

@@ -0,0 +1,2 @@
+export * from "./core/resource.mjs";
+//# sourceMappingURL=resource.mjs.map

package/resource.mjs.map

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

package/resources/accounts.d.mts

@@ -0,0 +1,48 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class Accounts extends APIResource {
+    /**
+     * Get Account Balances
+     *
+     * GET /v1/accounts
+     *
+     * - docs(kr): https://docs.upbit.com/kr/reference/get-balance
+     * - docs(global): https://global-docs.upbit.com/reference/get-balance
+     */
+    list(options?: RequestOptions): APIPromise<AccountListResponse>;
+}
+export type AccountListResponse = Array<AccountListResponse.AccountListResponseItem>;
+export declare namespace AccountListResponse {
+    interface AccountListResponseItem {
+        /**
+         * Average buy price of the asset.
+         */
+        avg_buy_price: string;
+        /**
+         * Indicates whether the average buy price has been modified.
+         */
+        avg_buy_price_modified: boolean;
+        /**
+         * Available amount or volume for orders. For digital assets, this represents the
+         * available quantity. For fiat currency, this represents the available amount.
+         */
+        balance: string;
+        /**
+         * Currency code to be queried.
+         */
+        currency: string;
+        /**
+         * Amount or quantity locked by pending orders or withdrawals.
+         */
+        locked: string;
+        /**
+         * Currency unit used as the basis for avg_buy_price.
+         */
+        unit_currency: string;
+    }
+}
+export declare namespace Accounts {
+    export { type AccountListResponse as AccountListResponse };
+}
+//# sourceMappingURL=accounts.d.mts.map

package/resources/accounts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.mts","sourceRoot":"","sources":["../src/resources/accounts.ts"],"names":[],"mappings":"OACO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;CAGhE;AAED,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,mBAAmB,CAAC,uBAAuB,CAAC,CAAC;AAErF,yBAAiB,mBAAmB,CAAC;IACnC,UAAiB,uBAAuB;QACtC;;WAEG;QACH,aAAa,EAAE,MAAM,CAAC;QAEtB;;WAEG;QACH,sBAAsB,EAAE,OAAO,CAAC;QAEhC;;;WAGG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;QAEf;;WAEG;QACH,aAAa,EAAE,MAAM,CAAC;KACvB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EAAE,KAAK,mBAAmB,IAAI,mBAAmB,EAAE,CAAC;CAC5D"}

package/resources/accounts.d.ts

@@ -0,0 +1,48 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+export declare class Accounts extends APIResource {
+    /**
+     * Get Account Balances
+     *
+     * GET /v1/accounts
+     *
+     * - docs(kr): https://docs.upbit.com/kr/reference/get-balance
+     * - docs(global): https://global-docs.upbit.com/reference/get-balance
+     */
+    list(options?: RequestOptions): APIPromise<AccountListResponse>;
+}
+export type AccountListResponse = Array<AccountListResponse.AccountListResponseItem>;
+export declare namespace AccountListResponse {
+    interface AccountListResponseItem {
+        /**
+         * Average buy price of the asset.
+         */
+        avg_buy_price: string;
+        /**
+         * Indicates whether the average buy price has been modified.
+         */
+        avg_buy_price_modified: boolean;
+        /**
+         * Available amount or volume for orders. For digital assets, this represents the
+         * available quantity. For fiat currency, this represents the available amount.
+         */
+        balance: string;
+        /**
+         * Currency code to be queried.
+         */
+        currency: string;
+        /**
+         * Amount or quantity locked by pending orders or withdrawals.
+         */
+        locked: string;
+        /**
+         * Currency unit used as the basis for avg_buy_price.
+         */
+        unit_currency: string;
+    }
+}
+export declare namespace Accounts {
+    export { type AccountListResponse as AccountListResponse };
+}
+//# sourceMappingURL=accounts.d.ts.map

package/resources/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../src/resources/accounts.ts"],"names":[],"mappings":"OACO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;CAGhE;AAED,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,mBAAmB,CAAC,uBAAuB,CAAC,CAAC;AAErF,yBAAiB,mBAAmB,CAAC;IACnC,UAAiB,uBAAuB;QACtC;;WAEG;QACH,aAAa,EAAE,MAAM,CAAC;QAEtB;;WAEG;QACH,sBAAsB,EAAE,OAAO,CAAC;QAEhC;;;WAGG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;QAEf;;WAEG;QACH,aAAa,EAAE,MAAM,CAAC;KACvB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EAAE,KAAK,mBAAmB,IAAI,mBAAmB,EAAE,CAAC;CAC5D"}

package/resources/accounts.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Accounts = void 0;
+const resource_1 = require("../core/resource.js");
+class Accounts extends resource_1.APIResource {
+    /**
+     * Get Account Balances
+     *
+     * GET /v1/accounts
+     *
+     * - docs(kr): https://docs.upbit.com/kr/reference/get-balance
+     * - docs(global): https://global-docs.upbit.com/reference/get-balance
+     */
+    list(options) {
+        return this._client.get('/v1/accounts', options);
+    }
+}
+exports.Accounts = Accounts;
+//# sourceMappingURL=accounts.js.map

package/resources/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../src/resources/accounts.ts"],"names":[],"mappings":";;;AACA,kDAA+C;AAI/C,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;OAOG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACF;AAZD,4BAYC"}

package/resources/accounts.mjs

@@ -0,0 +1,15 @@
+import { APIResource } from "../core/resource.mjs";
+export class Accounts extends APIResource {
+    /**
+     * Get Account Balances
+     *
+     * GET /v1/accounts
+     *
+     * - docs(kr): https://docs.upbit.com/kr/reference/get-balance
+     * - docs(global): https://global-docs.upbit.com/reference/get-balance
+     */
+    list(options) {
+        return this._client.get('/v1/accounts', options);
+    }
+}
+//# sourceMappingURL=accounts.mjs.map

package/resources/accounts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.mjs","sourceRoot":"","sources":["../src/resources/accounts.ts"],"names":[],"mappings":"OACO,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;OAOG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACF"}

package/resources/api-keys.d.mts

@@ -0,0 +1,33 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+export declare class APIKeys extends APIResource {
+    /**
+     * List API Keys
+     *
+     * GET /v1/api_keys
+     *
+     * - docs(kr): https://docs.upbit.com/kr/reference/list-api-keys
+     * - docs(global): https://global-docs.upbit.com/reference/list-api-keys
+     */
+    list(options?: RequestOptions): APIPromise<APIKeyListResponse>;
+}
+export type APIKeyListResponse = Array<APIKeyListResponse.APIKeyListResponseItem>;
+export declare namespace APIKeyListResponse {
+    interface APIKeyListResponseItem {
+        /**
+         * Access key of the API key.
+         */
+        access_key: string;
+        /**
+         * Expiration timestamp of the access key.
+         *
+         * [Format] yyyy-MM-dd'T'HH:mm:ss+09:00
+         */
+        expire_at: string;
+    }
+}
+export declare namespace APIKeys {
+    export { type APIKeyListResponse as APIKeyListResponse };
+}
+//# sourceMappingURL=api-keys.d.mts.map