@binance/fiat 7.0.1 → 8.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -14,14 +14,14 @@ let __binance_common = require("@binance/common");
14
14
 
15
15
  //#region package.json
16
16
  var name = "@binance/fiat";
17
- var version = "7.0.1";
17
+ var version = "8.0.1";
18
18
 
19
19
  //#endregion
20
- //#region src/rest-api/modules/fiat-api.ts
20
+ //#region src/rest-api/modules/api.ts
21
21
  /**
22
- * Binance Fiat REST API
22
+ * Fiat REST API
23
23
  *
24
- * OpenAPI Specification for the Binance Fiat REST API
24
+ * Query Binance fiat deposit and withdrawal history.
25
25
  *
26
26
  * The version of the OpenAPI document: 1.0.0
27
27
  *
@@ -31,9 +31,9 @@ var version = "7.0.1";
31
31
  * Do not edit the class manually.
32
32
  */
33
33
  /**
34
- * FiatApi - axios parameter creator
34
+ * Api - axios parameter creator
35
35
  */
36
- const FiatApiAxiosParamCreator = function(configuration) {
36
+ const ApiAxiosParamCreator = function(configuration) {
37
37
  return {
38
38
  deposit: async (currency, apiPaymentMethod, amount, recvWindow, ext) => {
39
39
  (0, __binance_common.assertParamExists)("deposit", "currency", currency);
@@ -148,33 +148,35 @@ const FiatApiAxiosParamCreator = function(configuration) {
148
148
  };
149
149
  };
150
150
  /**
151
- * FiatApi - object-oriented interface
152
- * @class FiatApi
151
+ * Api - object-oriented interface
152
+ * @class Api
153
153
  */
154
- var FiatApi = class {
154
+ var Api = class {
155
155
  constructor(configuration) {
156
156
  this.configuration = configuration;
157
- this.localVarAxiosParamCreator = FiatApiAxiosParamCreator(configuration);
157
+ this.localVarAxiosParamCreator = ApiAxiosParamCreator(configuration);
158
158
  }
159
159
  /**
160
160
  * Submit deposit request, in this version, we only support BRL deposit via pix.
161
161
  *
162
- *
163
- *
164
162
  * For BRL deposit via pix, you need to place an order before making a transfer from your bank.
165
163
  *
166
- * Before calling this api, please make sure you have already completed your KYC or KYB, and already activated your fiat service on our website.
164
+ * Before calling this api, please make sure you have already completed your KYC or KYB, and already activated your
165
+ * fiat service on our website.
167
166
  *
168
- * `timestamp`, `signature` and `recvWindow` are sent as query-string parameters, while the business fields (`currency`, `apiPaymentMethod`, `amount`, `ext`) are sent in the JSON request body with `Content-Type: application/json`.
167
+ * Weight(UID): 45000
169
168
  *
170
- * Weight: 45000
169
+ * Security Type: TRADE
171
170
  *
172
- * @summary Deposit(TRADE)
171
+ * Notes:
172
+ * - `timestamp`, `signature` and `recvWindow` are sent as query-string parameters, while the business fields (`currency`, `apiPaymentMethod`, `amount`, `ext`) are sent in the JSON request body with `Content-Type: application/json`.
173
+ *
174
+ * @summary Deposit (TRADE)
173
175
  * @param {DepositRequest} requestParameters Request parameters.
174
176
  * @returns {Promise<RestApiResponse<DepositResponse>>}
175
177
  * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
176
- * @memberof FiatApi
177
- * @see {@link https://developers.binance.com/docs/fiat/rest-api/Fiat-Deposit Binance API Documentation}
178
+ * @memberof Api
179
+ * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-fiat/api/rest-api/~#deposit Binance API Documentation}
178
180
  */
179
181
  async deposit(requestParameters) {
180
182
  const localVarAxiosArgs = await this.localVarAxiosParamCreator.deposit(requestParameters?.currency, requestParameters?.apiPaymentMethod, requestParameters?.amount, requestParameters?.recvWindow, requestParameters?.ext);
@@ -183,20 +185,22 @@ var FiatApi = class {
183
185
  /**
184
186
  * Submit withdraw request, in this version, we support BRL,ARS,MXN withdrawal via bank_transfer.
185
187
  *
186
- * You need to call this api first, and call query order detail api in a loop to get the status of the order until this order is successful.
188
+ * You need to call this api first, and call query order detail api in a loop to get the status of the order until
189
+ * this order is successful.
187
190
  *
188
- * Before calling this API, please ensure you have completed your KYC or KYB, activated your fiat service, and verified your destination bank account on our website.
191
+ * Before calling this api, please make sure you have already completed your KYC or KYB, and already activated your
192
+ * fiat service on our website.
189
193
  *
190
- * you need to bind your bank account on web/app before using the corresponding account number
194
+ * Weight(UID): 45000
191
195
  *
192
- * Weight: 45000
196
+ * Security Type: TRADE
193
197
  *
194
- * @summary Fiat Withdraw(WITHDRAW)
198
+ * @summary Fiat Withdraw (TRADE)
195
199
  * @param {FiatWithdrawRequest} requestParameters Request parameters.
196
200
  * @returns {Promise<RestApiResponse<FiatWithdrawResponse>>}
197
201
  * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
198
- * @memberof FiatApi
199
- * @see {@link https://developers.binance.com/docs/fiat/rest-api/Fiat-Withdraw Binance API Documentation}
202
+ * @memberof Api
203
+ * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-fiat/api/rest-api/~#fiat-withdraw Binance API Documentation}
200
204
  */
201
205
  async fiatWithdraw(requestParameters) {
202
206
  const localVarAxiosArgs = await this.localVarAxiosParamCreator.fiatWithdraw(requestParameters?.currency, requestParameters?.apiPaymentMethod, requestParameters?.amount, requestParameters?.accountInfo, requestParameters?.recvWindow, requestParameters?.ext);
@@ -205,39 +209,42 @@ var FiatApi = class {
205
209
  /**
206
210
  * Get Fiat Deposit/Withdraw History
207
211
  *
208
- * If beginTime and endTime are not sent, the recent 30-day data will be returned.
212
+ * Weight(UID): 45000
213
+ *
214
+ * Security Type: USER_DATA
209
215
  *
210
- * Weight: 45000
216
+ * Notes:
217
+ * - If `beginTime` and `endTime` are not sent, recent 30-day data is returned.
211
218
  *
212
219
  * @summary Get Fiat Deposit/Withdraw History (USER_DATA)
213
220
  * @param {GetFiatDepositWithdrawHistoryRequest} requestParameters Request parameters.
214
221
  * @returns {Promise<RestApiResponse<GetFiatDepositWithdrawHistoryResponse>>}
215
222
  * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
216
- * @memberof FiatApi
217
- * @see {@link https://developers.binance.com/docs/fiat/rest-api/Get-Fiat-Deposit-Withdraw-History Binance API Documentation}
223
+ * @memberof Api
224
+ * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-fiat/api/rest-api/~#get-fiat-deposit-withdraw-history Binance API Documentation}
218
225
  */
219
226
  async getFiatDepositWithdrawHistory(requestParameters) {
220
227
  const localVarAxiosArgs = await this.localVarAxiosParamCreator.getFiatDepositWithdrawHistory(requestParameters?.transactionType, requestParameters?.beginTime, requestParameters?.endTime, requestParameters?.page, requestParameters?.rows, requestParameters?.recvWindow);
221
228
  return (0, __binance_common.sendRequest)(this.configuration, localVarAxiosArgs.endpoint, localVarAxiosArgs.method, localVarAxiosArgs.queryParams, localVarAxiosArgs.bodyParams, localVarAxiosArgs.headerParams, localVarAxiosArgs?.timeUnit, { isSigned: true });
222
229
  }
223
230
  /**
224
- * Get Fiat Deposit/Withdraw History
231
+ * Get Fiat Payments History
232
+ *
233
+ * Weight(IP): 1
225
234
  *
226
- * If beginTime and endTime are not sent, the recent 30-day data will be returned.
227
- * paymentMethod: Only when requesting payments history for buy (transactionType=0), response contains paymentMethod representing the way of purchase. Now we have:
228
- * Cash Balance
229
- * Credit Card
230
- * Online Banking
231
- * Bank Transfer
235
+ * Security Type: USER_DATA
232
236
  *
233
- * Weight: 1
237
+ * Notes:
238
+ * - If `beginTime` and `endTime` are not sent, recent 30-day data is returned.
239
+ * - `paymentMethod` is returned only when querying buy history (`transactionType=0`).
240
+ * - Supported payment methods: `Cash Balance`, `Credit Card`, `Online Banking`, `Bank Transfer`.
234
241
  *
235
242
  * @summary Get Fiat Payments History (USER_DATA)
236
243
  * @param {GetFiatPaymentsHistoryRequest} requestParameters Request parameters.
237
244
  * @returns {Promise<RestApiResponse<GetFiatPaymentsHistoryResponse>>}
238
245
  * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
239
- * @memberof FiatApi
240
- * @see {@link https://developers.binance.com/docs/fiat/rest-api/Get-Fiat-Payments-History Binance API Documentation}
246
+ * @memberof Api
247
+ * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-fiat/api/rest-api/~#get-fiat-payments-history Binance API Documentation}
241
248
  */
242
249
  async getFiatPaymentsHistory(requestParameters) {
243
250
  const localVarAxiosArgs = await this.localVarAxiosParamCreator.getFiatPaymentsHistory(requestParameters?.transactionType, requestParameters?.beginTime, requestParameters?.endTime, requestParameters?.page, requestParameters?.rows, requestParameters?.recvWindow);
@@ -246,29 +253,40 @@ var FiatApi = class {
246
253
  /**
247
254
  * Get Order Detail
248
255
  *
249
- * Before calling this api, please make sure you have already completed your KYC or KYB, and already activated your fiat service on our website.
256
+ * Before calling this api, please make sure you have already completed your KYC or KYB, and already activated your
257
+ * fiat service on our website.
258
+ *
259
+ * Weight(IP): 1
250
260
  *
251
- * Weight: 1
261
+ * Security Type: USER_DATA
252
262
  *
253
- * @summary Get Order Detail(USER_DATA)
263
+ * @summary Get Order Detail (USER_DATA)
254
264
  * @param {GetOrderDetailRequest} requestParameters Request parameters.
255
265
  * @returns {Promise<RestApiResponse<GetOrderDetailResponse>>}
256
266
  * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
257
- * @memberof FiatApi
258
- * @see {@link https://developers.binance.com/docs/fiat/rest-api/Get-Order-Detail Binance API Documentation}
267
+ * @memberof Api
268
+ * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-fiat/api/rest-api/~#get-order-detail Binance API Documentation}
259
269
  */
260
270
  async getOrderDetail(requestParameters) {
261
271
  const localVarAxiosArgs = await this.localVarAxiosParamCreator.getOrderDetail(requestParameters?.orderNo, requestParameters?.recvWindow);
262
272
  return (0, __binance_common.sendRequest)(this.configuration, localVarAxiosArgs.endpoint, localVarAxiosArgs.method, localVarAxiosArgs.queryParams, localVarAxiosArgs.bodyParams, localVarAxiosArgs.headerParams, localVarAxiosArgs?.timeUnit, { isSigned: true });
263
273
  }
264
274
  };
275
+ let DepositApiPaymentMethodEnum = /* @__PURE__ */ function(DepositApiPaymentMethodEnum$1) {
276
+ DepositApiPaymentMethodEnum$1["pix"] = "pix";
277
+ return DepositApiPaymentMethodEnum$1;
278
+ }({});
279
+ let FiatWithdrawApiPaymentMethodEnum = /* @__PURE__ */ function(FiatWithdrawApiPaymentMethodEnum$1) {
280
+ FiatWithdrawApiPaymentMethodEnum$1["bank_transfer"] = "bank_transfer";
281
+ return FiatWithdrawApiPaymentMethodEnum$1;
282
+ }({});
265
283
 
266
284
  //#endregion
267
285
  //#region src/rest-api/rest-api.ts
268
286
  /**
269
- * Binance Fiat REST API
287
+ * Fiat REST API
270
288
  *
271
- * OpenAPI Specification for the Binance Fiat REST API
289
+ * Query Binance fiat deposit and withdrawal history.
272
290
  *
273
291
  * The version of the OpenAPI document: 1.0.0
274
292
  *
@@ -280,7 +298,7 @@ var FiatApi = class {
280
298
  var RestAPI = class {
281
299
  constructor(configuration) {
282
300
  this.configuration = configuration;
283
- this.fiatApi = new FiatApi(configuration);
301
+ this.api = new Api(configuration);
284
302
  }
285
303
  /**
286
304
  * Generic function to send a request.
@@ -309,109 +327,121 @@ var RestAPI = class {
309
327
  /**
310
328
  * Submit deposit request, in this version, we only support BRL deposit via pix.
311
329
  *
312
- *
313
- *
314
330
  * For BRL deposit via pix, you need to place an order before making a transfer from your bank.
315
331
  *
316
- * Before calling this api, please make sure you have already completed your KYC or KYB, and already activated your fiat service on our website.
332
+ * Before calling this api, please make sure you have already completed your KYC or KYB, and already activated your
333
+ * fiat service on our website.
317
334
  *
318
- * `timestamp`, `signature` and `recvWindow` are sent as query-string parameters, while the business fields (`currency`, `apiPaymentMethod`, `amount`, `ext`) are sent in the JSON request body with `Content-Type: application/json`.
335
+ * Weight(UID): 45000
319
336
  *
320
- * Weight: 45000
337
+ * Security Type: TRADE
321
338
  *
322
- * @summary Deposit(TRADE)
339
+ * Notes:
340
+ * - `timestamp`, `signature` and `recvWindow` are sent as query-string parameters, while the business fields (`currency`, `apiPaymentMethod`, `amount`, `ext`) are sent in the JSON request body with `Content-Type: application/json`.
341
+ *
342
+ * @summary Deposit (TRADE)
323
343
  * @param {DepositRequest} requestParameters Request parameters.
324
344
  *
325
345
  * @returns {Promise<RestApiResponse<DepositResponse>>}
326
346
  * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
327
- * @see {@link https://developers.binance.com/docs/fiat/rest-api/Fiat-Deposit Binance API Documentation}
347
+ * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-fiat/api/rest-api/~#deposit Binance API Documentation}
328
348
  */
329
349
  deposit(requestParameters) {
330
- return this.fiatApi.deposit(requestParameters);
350
+ return this.api.deposit(requestParameters);
331
351
  }
332
352
  /**
333
353
  * Submit withdraw request, in this version, we support BRL,ARS,MXN withdrawal via bank_transfer.
334
354
  *
335
- * You need to call this api first, and call query order detail api in a loop to get the status of the order until this order is successful.
355
+ * You need to call this api first, and call query order detail api in a loop to get the status of the order until
356
+ * this order is successful.
336
357
  *
337
- * Before calling this API, please ensure you have completed your KYC or KYB, activated your fiat service, and verified your destination bank account on our website.
358
+ * Before calling this api, please make sure you have already completed your KYC or KYB, and already activated your
359
+ * fiat service on our website.
338
360
  *
339
- * you need to bind your bank account on web/app before using the corresponding account number
361
+ * Weight(UID): 45000
340
362
  *
341
- * Weight: 45000
363
+ * Security Type: TRADE
342
364
  *
343
- * @summary Fiat Withdraw(WITHDRAW)
365
+ * @summary Fiat Withdraw (TRADE)
344
366
  * @param {FiatWithdrawRequest} requestParameters Request parameters.
345
367
  *
346
368
  * @returns {Promise<RestApiResponse<FiatWithdrawResponse>>}
347
369
  * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
348
- * @see {@link https://developers.binance.com/docs/fiat/rest-api/Fiat-Withdraw Binance API Documentation}
370
+ * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-fiat/api/rest-api/~#fiat-withdraw Binance API Documentation}
349
371
  */
350
372
  fiatWithdraw(requestParameters) {
351
- return this.fiatApi.fiatWithdraw(requestParameters);
373
+ return this.api.fiatWithdraw(requestParameters);
352
374
  }
353
375
  /**
354
376
  * Get Fiat Deposit/Withdraw History
355
377
  *
356
- * If beginTime and endTime are not sent, the recent 30-day data will be returned.
378
+ * Weight(UID): 45000
379
+ *
380
+ * Security Type: USER_DATA
357
381
  *
358
- * Weight: 45000
382
+ * Notes:
383
+ * - If `beginTime` and `endTime` are not sent, recent 30-day data is returned.
359
384
  *
360
385
  * @summary Get Fiat Deposit/Withdraw History (USER_DATA)
361
386
  * @param {GetFiatDepositWithdrawHistoryRequest} requestParameters Request parameters.
362
387
  *
363
388
  * @returns {Promise<RestApiResponse<GetFiatDepositWithdrawHistoryResponse>>}
364
389
  * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
365
- * @see {@link https://developers.binance.com/docs/fiat/rest-api/Get-Fiat-Deposit-Withdraw-History Binance API Documentation}
390
+ * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-fiat/api/rest-api/~#get-fiat-deposit-withdraw-history Binance API Documentation}
366
391
  */
367
392
  getFiatDepositWithdrawHistory(requestParameters) {
368
- return this.fiatApi.getFiatDepositWithdrawHistory(requestParameters);
393
+ return this.api.getFiatDepositWithdrawHistory(requestParameters);
369
394
  }
370
395
  /**
371
- * Get Fiat Deposit/Withdraw History
396
+ * Get Fiat Payments History
397
+ *
398
+ * Weight(IP): 1
372
399
  *
373
- * If beginTime and endTime are not sent, the recent 30-day data will be returned.
374
- * paymentMethod: Only when requesting payments history for buy (transactionType=0), response contains paymentMethod representing the way of purchase. Now we have:
375
- * Cash Balance
376
- * Credit Card
377
- * Online Banking
378
- * Bank Transfer
400
+ * Security Type: USER_DATA
379
401
  *
380
- * Weight: 1
402
+ * Notes:
403
+ * - If `beginTime` and `endTime` are not sent, recent 30-day data is returned.
404
+ * - `paymentMethod` is returned only when querying buy history (`transactionType=0`).
405
+ * - Supported payment methods: `Cash Balance`, `Credit Card`, `Online Banking`, `Bank Transfer`.
381
406
  *
382
407
  * @summary Get Fiat Payments History (USER_DATA)
383
408
  * @param {GetFiatPaymentsHistoryRequest} requestParameters Request parameters.
384
409
  *
385
410
  * @returns {Promise<RestApiResponse<GetFiatPaymentsHistoryResponse>>}
386
411
  * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
387
- * @see {@link https://developers.binance.com/docs/fiat/rest-api/Get-Fiat-Payments-History Binance API Documentation}
412
+ * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-fiat/api/rest-api/~#get-fiat-payments-history Binance API Documentation}
388
413
  */
389
414
  getFiatPaymentsHistory(requestParameters) {
390
- return this.fiatApi.getFiatPaymentsHistory(requestParameters);
415
+ return this.api.getFiatPaymentsHistory(requestParameters);
391
416
  }
392
417
  /**
393
418
  * Get Order Detail
394
419
  *
395
- * Before calling this api, please make sure you have already completed your KYC or KYB, and already activated your fiat service on our website.
420
+ * Before calling this api, please make sure you have already completed your KYC or KYB, and already activated your
421
+ * fiat service on our website.
422
+ *
423
+ * Weight(IP): 1
396
424
  *
397
- * Weight: 1
425
+ * Security Type: USER_DATA
398
426
  *
399
- * @summary Get Order Detail(USER_DATA)
427
+ * @summary Get Order Detail (USER_DATA)
400
428
  * @param {GetOrderDetailRequest} requestParameters Request parameters.
401
429
  *
402
430
  * @returns {Promise<RestApiResponse<GetOrderDetailResponse>>}
403
431
  * @throws {RequiredError | ConnectorClientError | UnauthorizedError | ForbiddenError | TooManyRequestsError | RateLimitBanError | ServerError | NotFoundError | NetworkError | BadRequestError}
404
- * @see {@link https://developers.binance.com/docs/fiat/rest-api/Get-Order-Detail Binance API Documentation}
432
+ * @see {@link https://developers.binance.com/en/docs/catalog/investment-and-services-fiat/api/rest-api/~#get-order-detail Binance API Documentation}
405
433
  */
406
434
  getOrderDetail(requestParameters) {
407
- return this.fiatApi.getOrderDetail(requestParameters);
435
+ return this.api.getOrderDetail(requestParameters);
408
436
  }
409
437
  };
410
438
 
411
439
  //#endregion
412
440
  //#region src/rest-api/index.ts
413
441
  var rest_api_exports = /* @__PURE__ */ __export({
414
- FiatApi: () => FiatApi,
442
+ Api: () => Api,
443
+ DepositApiPaymentMethodEnum: () => DepositApiPaymentMethodEnum,
444
+ FiatWithdrawApiPaymentMethodEnum: () => FiatWithdrawApiPaymentMethodEnum,
415
445
  RestAPI: () => RestAPI
416
446
  });
417
447