@binance/fiat 7.0.1 → 8.0.0

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