معرفی API ارزینجا (Arzinja)
به مستندات API صرافی ارزینجا خوش آمدید! این API به شما امکان می‌دهد به دنیای معاملات ارزهای دیجیتال متصل شوید و از قابلیت‌های پیشرفته این پلتفرم بهره‌مند شوید. با استفاده از API ارزینجا، کاربران و توسعه‌دهندگان می‌توانند به صورت مستقیم و هوشمندانه با بازارهای متنوع ارز دیجیتال ارتباط برقرار کنند، اطلاعات به‌روز بازار را مشاهده کنند و معاملات خود را به شکلی سریع و کارآمد مدیریت نمایند. API ارزینجا با هدف تسهیل دسترسی کاربران به ابزارهای پیشرفته طراحی شده است و امکان سفارشی‌سازی فرآیندها را بر اساس نیازهای مختلف فراهم میکند. از مدیریت حساب کاربری و پیگیری فعالیت‌ها گرفته تا اجرای معاملات خودکار، همه این امکانات در اختیار شماست تا تجربه‌ای روان و حرفه‌ای از معاملات ارزهای دیجیتال داشته باشید. این API بستری منعطف و کاربردی برای تمامی کاربران، از مبتدی تا حرفه‌ای، فراهم میکند تا بتوانند از امکاناتی نوآورانه بهره‌مند شوند و تجربه معاملاتی خود را به سطح بالاتری ارتقا دهند.
آدرس پایه
https://api-v2.arzinja.app/api
Postman Collection
برای تسهیل استفاده کاربران از API صرافی ارزینجا، یک کالکشن آماده برای Postman در دسترس قرار گرفته است. این کالکشن شامل تمامی مسیرها (endpoints) و تنظیمات موردنیاز برای ارسال درخواست‌ها به API ارزینجا است و به شما امکان می‌دهد بدون نیاز به تنظیمات دستی اولیه، به سرعت با API کار کنید.
مراحل استفاده از کالکشن:
1. دانلود کالکشن:
کالکشن Postman را از لینک زیر دانلود کنید:
2. ایمپورت کردن کالکشن در Postman:
- Postman را باز کنید.
- از منوی بالا گزینه Import را انتخاب کنید.
- فایل کالکشن دانلود شده را آپلود کنید.
3. ساختار کالکشن:
- پوشه Public: شامل اندپوینت‌های عمومی است که برای استفاده از آن‌ها نیازی به احراز هویت یا رمزنگاری نیست.
- پوشه Private: شامل اندپوینت‌های خصوصی است که نیاز به احراز هویت و رمزنگاری دارند. برای سهولت، در قسمت Pre-request Script این پوشه، یک اسکریپت آماده نوشته شده است که تمام مراحل موردنیاز از جمله تولید امضای دیجیتال (HMAC)، تنظیم سربرگ‌ها و افزودن پارامترهای الزامی را به صورت خودکار انجام می‌دهد.
4. تنظیم متغیرهای محیطی (Environment Variables):
برای استفاده بهینه از کالکشن، ابتدا متغیرهای زیر را در محیط (Environment) Postman تنظیم کنید:
- BASE_URL: آدرس سرور API شما.
- API_KEY: کلید API که در بخش مدیریت API ایجاد کرده‌اید.
- API_SECRET: کلید Secret مرتبط با API Key.
5. ارسال درخواست‌ها:
- مسیر موردنظر را در پوشه مربوطه (Public یا Private) باز کنید.
- بسته به نوع درخواست (GET, POST, PUT) مقادیر موردنیاز مانند پارامترها یا body را وارد کرده و درخواست را ارسال کنید.
6. بررسی پاسخ‌ها:
پاسخ‌های سرور به صورت خودکار در بخش Response Postman نمایش داده می‌شود.
مزایای استفاده از کالکشن
- کاهش زمان راه‌اندازی و تست API.
- دسته‌بندی شفاف اندپوینت‌ها در پوشه‌های Public و Private.
- اسکریپت از پیش نوشته شده برای مدیریت درخواست‌های خصوصی.
- ساختاردهی شده برای تمامی مسیرها و پارامترها.
- امکان شخصی‌سازی درخواست‌ها با حداقل تنظیمات دستی.
با این روش می‌توانید به راحتی قابلیت‌های مختلف API ارزینجا را بررسی کرده و در پروژه‌های خود از آن‌ها بهره‌برداری کنید.
سرویس های عمومی
لیست ارزها (Currency List)
این درخواست برای دریافت لیست ارزهای موجود در بازار ارزینجا استفاده می‌شود.
پارامترها
شماره صفحه مورد نظر
مقدار پیش فرض : 1
محدوده مجاز: 1 الی supported_max_page
integerpage
تعداد ارزهای نمایش داده شده در هر صفحه
مقدار پیش فرض : 10
محدوده مجاز: 1 الی 100
integerper_page
جستجوی ارز بر اساس نام یا نماد
نمونه: btc
stringq
Currency List
/v1/services/public/currencies
GET
RESULT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
{
"code": 200,
"success": true,
"message": "عملیات موفقیت آمیز بود",
"result": [
{
"currency_id": 37,
"title": "بیت کوین",
"slug": "bitcoin",
"symbol": "BTC",
"position": 20,
"is_fiat": 0,
"balance_decimal": "6",
"price_decimal": "1",
"is_depositable": true,
"is_withdrawable": 1,
"otc_tradeable": 1,
"p2p_tradeable": 1,
"p2p_tradingview_pair": "BTCIRT",
"networks": null
},
{
"currency_id": 3904,
"title": "روت استاک اسمارت بیت کوین",
"slug": "rbtc",
"symbol": "RBTC",
"position": 1000,
"is_fiat": 0,
"balance_decimal": "0",
"price_decimal": "12",
"is_depositable": false,
"is_withdrawable": 0,
"otc_tradeable": 0,
"p2p_tradeable": 0,
"p2p_tradingview_pair": null,
"networks": null
}
],
"pagination": {
"total": 3,
"count": 2,
"per_page": 2,
"current_page": 1,
"total_pages": 2,
"links": {
"next": "{{BASE_URL}}/v1/currencies?page=2"
}
}
}دریافت لیست ارزهای معاملاتی بازار ارزینجا (Markets Pair List)
این درخواست برای دریافت لیست ارزهای معاملاتی در بازار ارزینجا استفاده می‌شود.
پارامترها
شماره صفحه مورد نظر
مقدار پیش فرض : 1
محدوده مجاز: 1 الی supported_max_page
integerpage
تعداد جفت ارزهای نمایش داده شده در هر صفحه
مقدار پیش فرض : 10
محدوده مجاز: 1 الی 100
integerper_page
جستجوی جفت ارز بر اساس نام یا نماد
نمونه: btc
stringsearch
نماد ارز پایه مورد نظر
نمونه: BTC
stringbase_asset
نوع ارائه‌دهنده بازار
نوع otc برای دریافت جزئیات جفت ارزها در معاملاهای آسان خرید و فروش، نوع exchange برای معاملات آسان تبدیل و نوع p2p برای معاملات پیشرفته استفاده می‌شود.
مقدار پیش فرض : otc
مقادیر مجاز: otc, p2p, exchange
stringprovider_type
Markets List
/v1/services/market/all-market
GET
RESULT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
{
"code": 200,
"success": true,
"message": "عملیات موفقیت آمیز بود",
"result": [
{
"BTCIRT": {
"pair_id": 2292,
"pair": "BTCIRT",
"baseAsset": "BTC",
"baseAssetPrecision": "6",
"quoteAsset": "IRT",
"quotePrecision": "0",
"faName": "بیت کوین-تومان",
"enName": "Bitcoin-Toman",
"faBaseAsset": "بیت کوین",
"enBaseAsset": "Bitcoin",
"baseAssetSlug": "bitcoin",
"faQuoteAsset": "تومان",
"enQuoteAsset": "Toman",
"quoteAssetSlug": "toman",
"stepSize": "5",
"tickSize": "0",
"minQty": "0.00007",
"maxQty": "2.11541",
"minNotional": "300000",
"maxNotional": "3000000000",
"stats": {
"lastPrice": "7305707684",
"lastPriceUsd": "93729.0",
"24h_lowPrice": "7253064410",
"24h_highPrice": "7425979937",
"24h_ch": "-1.27",
"in_usd": "93733.7"
},
"buyStatus": 1,
"sellStatus": 1,
"exchangeStatus": 1,
"createdAt": "2024-04-15 00:57:23",
"isNew": 0,
"isZeroFee": 0,
"is_limit_enabled": 1,
"is_trend": 1,
"favorite": false
}
},
{
"ETHIRT": {
"pair_id": 2214,
"pair": "ETHIRT",
"baseAsset": "ETH",
"baseAssetPrecision": "4",
"quoteAsset": "IRT",
"quotePrecision": "0",
"faName": "اتریوم-تومان",
"enName": "Ethereum-Toman",
"faBaseAsset": "اتریوم",
"enBaseAsset": "Ethereum",
"baseAssetSlug": "ethereum",
"faQuoteAsset": "تومان",
"enQuoteAsset": "Toman",
"quoteAssetSlug": "toman",
"stepSize": "4",
"tickSize": "0",
"minQty": "0.0018",
"maxQty": "59.7807",
"minNotional": "300000",
"maxNotional": "3000000000",
"stats": {
"lastPrice": "266384832",
"lastPriceUsd": "3417.6",
"24h_lowPrice": "259380694",
"24h_highPrice": "267448001",
"24h_ch": "0.92",
"in_usd": "3414.42"
},
"buyStatus": 1,
"sellStatus": 1,
"exchangeStatus": 1,
"createdAt": "2024-04-15 00:57:23",
"isNew": 0,
"isZeroFee": 0,
"is_limit_enabled": 1,
"is_trend": 1,
"favorite": false
}
},
{
"USDTIRT": {
"pair_id": 2063,
"pair": "USDTIRT",
"baseAsset": "USDT",
"baseAssetPrecision": "2",
"quoteAsset": "IRT",
"quotePrecision": "0",
"faName": "تتر-تومان",
"enName": "TetherUS-Toman",
"faBaseAsset": "تتر",
"enBaseAsset": "TetherUS",
"baseAssetSlug": "tetherus",
"faQuoteAsset": "تومان",
"enQuoteAsset": "Toman",
"quoteAssetSlug": "toman",
"stepSize": "2",
"tickSize": "0",
"minQty": "3",
"maxQty": "38600",
"minNotional": "300000",
"maxNotional": "3000000000",
"stats": {
"lastPrice": "77945",
"lastPriceUsd": "1",
"24h_lowPrice": "6006051975",
"24h_highPrice": "6347840800",
"24h_ch": "-3.7",
"in_usd": "1"
},
"buyStatus": 1,
"sellStatus": 1,
"exchangeStatus": 1,
"createdAt": "2024-04-15 00:57:23",
"isNew": 0,
"isZeroFee": 0,
"is_limit_enabled": 1,
"is_trend": 0,
"favorite": false
}
},
{
"DOGEIRT": {
"pair_id": 2337,
"pair": "DOGEIRT",
"baseAsset": "DOGE",
"baseAssetPrecision": "2",
"quoteAsset": "IRT",
"quotePrecision": "0",
"faName": "دوج کوین-تومان",
"enName": "Dogecoin-Toman",
"faBaseAsset": "دوج کوین",
"enBaseAsset": "Dogecoin",
"baseAssetSlug": "dogecoin",
"faQuoteAsset": "تومان",
"enQuoteAsset": "Toman",
"quoteAssetSlug": "toman",
"stepSize": "0",
"tickSize": "0",
"minQty": "4",
"maxQty": "636962",
"minNotional": "300000",
"maxNotional": "3000000000",
"stats": {
"lastPrice": "24953",
"lastPriceUsd": "0.32014",
"24h_lowPrice": "24319",
"24h_highPrice": "25678",
"24h_ch": "-0.63",
"in_usd": "0.32009"
},
"buyStatus": 1,
"sellStatus": 1,
"exchangeStatus": 1,
"createdAt": "2024-04-15 00:57:23",
"isNew": 0,
"isZeroFee": 0,
"is_limit_enabled": 1,
"is_trend": 0,
"favorite": false
}
},
{
"TRXIRT": {
"pair_id": 2233,
"pair": "TRXIRT",
"baseAsset": "TRX",
"baseAssetPrecision": "2",
"quoteAsset": "IRT",
"quotePrecision": "0",
"faName": "ترون-تومان",
"enName": "TRON-Toman",
"faBaseAsset": "ترون",
"enBaseAsset": "TRON",
"baseAssetSlug": "tron",
"faQuoteAsset": "تومان",
"enQuoteAsset": "Toman",
"quoteAssetSlug": "toman",
"stepSize": "1",
"tickSize": "0",
"minQty": "23.2",
"maxQty": "769230.7",
"minNotional": "300000",
"maxNotional": "3000000000",
"stats": {
"lastPrice": "20203",
"lastPriceUsd": "0.2592",
"24h_lowPrice": "20016",
"24h_highPrice": "20522",
"24h_ch": "0.7",
"in_usd": "0.2591"
},
"buyStatus": 1,
"sellStatus": 1,
"exchangeStatus": 1,
"createdAt": "2024-04-15 00:57:23",
"isNew": 0,
"isZeroFee": 0,
"is_limit_enabled": 1,
"is_trend": 1,
"favorite": false
}
},
{
"SOLIRT": {
"pair_id": 2208,
"pair": "SOLIRT",
"baseAsset": "SOL",
"baseAssetPrecision": "4",
"quoteAsset": "IRT",
"quotePrecision": "0",
"faName": "سولانا-تومان",
"enName": "Solana-Toman",
"faBaseAsset": "سولانا",
"enBaseAsset": "Solana",
"baseAssetSlug": "solana",
"faQuoteAsset": "تومان",
"enQuoteAsset": "Toman",
"quoteAssetSlug": "toman",
"stepSize": "3",
"tickSize": "0",
"minQty": "0.031",
"maxQty": "1075.326",
"minNotional": "300000",
"maxNotional": "3000000000",
"stats": {
"lastPrice": "14988823",
"lastPriceUsd": "192.3",
"24h_lowPrice": "14701985",
"24h_highPrice": "15381666",
"24h_ch": "-0.18",
"in_usd": "192.25"
},
"buyStatus": 1,
"sellStatus": 1,
"exchangeStatus": 1,
"createdAt": "2024-04-15 00:57:23",
"isNew": 1,
"isZeroFee": 0,
"is_limit_enabled": 1,
"is_trend": 0,
"favorite": false
}
},
{
"XRPIRT": {
"pair_id": 2128,
"pair": "XRPIRT",
"baseAsset": "XRP",
"baseAssetPrecision": "2",
"quoteAsset": "IRT",
"quotePrecision": "0",
"faName": "ریپل-تومان",
"enName": "Ripple-Toman",
"faBaseAsset": "ریپل",
"enBaseAsset": "Ripple",
"baseAssetSlug": "ripple",
"faQuoteAsset": "تومان",
"enQuoteAsset": "Toman",
"quoteAssetSlug": "toman",
"stepSize": "0",
"tickSize": "0",
"minQty": "3",
"maxQty": "92153",
"minNotional": "300000",
"maxNotional": "3000000000",
"stats": {
"lastPrice": "165017",
"lastPriceUsd": "2.1171",
"24h_lowPrice": "161486",
"24h_highPrice": "171229",
"24h_ch": "-2.74",
"in_usd": "2.1162"
},
"buyStatus": 1,
"sellStatus": 1,
"exchangeStatus": 1,
"createdAt": "2024-04-15 00:57:23",
"isNew": 0,
"isZeroFee": 0,
"is_limit_enabled": 1,
"is_trend": 1,
"favorite": false
}
},
{
"LTCIRT": {
"pair_id": 2430,
"pair": "LTCIRT",
"baseAsset": "LTC",
"baseAssetPrecision": "4",
"quoteAsset": "IRT",
"quotePrecision": "0",
"faName": "لایت کوین-تومان",
"enName": "Litecoin-Toman",
"faBaseAsset": "لایت کوین",
"enBaseAsset": "Litecoin",
"baseAssetSlug": "litecoin",
"faQuoteAsset": "تومان",
"enQuoteAsset": "Toman",
"quoteAssetSlug": "toman",
"stepSize": "3",
"tickSize": "0",
"minQty": "0.06",
"maxQty": "1960.399",
"minNotional": "300000",
"maxNotional": "3000000000",
"stats": {
"lastPrice": "7830354",
"lastPriceUsd": "100.46",
"24h_lowPrice": "7794500",
"24h_highPrice": "7793720",
"24h_ch": "0.51",
"in_usd": "100.44"
},
"buyStatus": 1,
"sellStatus": 1,
"exchangeStatus": 1,
"createdAt": "2024-04-15 00:57:23",
"isNew": 0,
"isZeroFee": 0,
"is_limit_enabled": 1,
"is_trend": 0,
"favorite": false
}
},
{
"SHIBIRT": {
"pair_id": 2272,
"pair": "SHIBIRT",
"baseAsset": "SHIB",
"baseAssetPrecision": "0",
"quoteAsset": "IRT",
"quotePrecision": "0",
"faName": "شیبا-تومان",
"enName": "SHIBA INU-Toman",
"faBaseAsset": "شیبا",
"enBaseAsset": "SHIBA INU",
"baseAssetSlug": "shiba-inu",
"faQuoteAsset": "تومان",
"enQuoteAsset": "Toman",
"quoteAssetSlug": "toman",
"stepSize": "0",
"tickSize": "3",
"minQty": "55224",
"maxQty": "9174311926",
"minNotional": "300000",
"maxNotional": "3000000000",
"stats": {
"lastPrice": "1.692",
"lastPriceUsd": "0.00002172",
"24h_lowPrice": "1.657",
"24h_highPrice": "1.748",
"24h_ch": "-1.41",
"in_usd": "0.00002171"
},
"buyStatus": 1,
"sellStatus": 1,
"exchangeStatus": 1,
"createdAt": "2024-04-15 00:57:23",
"isNew": 0,
"isZeroFee": 0,
"is_limit_enabled": 1,
"is_trend": 0,
"favorite": false
}
},
{
"BABYDOGEIRT": {
"pair_id": 51110,
"pair": "BABYDOGEIRT",
"baseAsset": "BABYDOGE",
"baseAssetPrecision": "0",
"quoteAsset": "IRT",
"quotePrecision": "0",
"faName": "بیبی دوج-تومان",
"enName": "Baby Doge Coin-Toman",
"faBaseAsset": "بیبی دوج",
"enBaseAsset": "Baby Doge Coin",
"baseAssetSlug": "baby-doge-coin",
"faQuoteAsset": "تومان",
"enQuoteAsset": "Toman",
"quoteAssetSlug": "toman",
"stepSize": "0",
"tickSize": "7",
"minQty": "1000000000",
"maxQty": "3041362530413",
"minNotional": "300000",
"maxNotional": "3000000000",
"stats": {
"lastPrice": "0.0002458",
"lastPriceUsd": "0.000000003154",
"24h_lowPrice": "0.0002397",
"24h_highPrice": "0.0002558",
"24h_ch": "-3.62",
"in_usd": "0.000000003153"
},
"buyStatus": 1,
"sellStatus": 1,
"exchangeStatus": 1,
"createdAt": "2024-04-15 00:57:23",
"isNew": 0,
"isZeroFee": 0,
"is_limit_enabled": 1,
"is_trend": 0,
"favorite": false
}
}
],
"pagination": {
"total": 656,
"count": 10,
"per_page": 10,
"current_page": 1,
"total_pages": 66,
"links": {
"next": "{{BASE_URL}}/v1/market/all-market?page=2"
}
}
}دفترچه سفارشات (P2P Orderbook)
این درخواست برای دریافت لیست تاریخچه معاملات انجام شده در بازار ارزینجا استفاده می‌شود.
پارامترها
جفت ارز مورد نظر
مقدار پیش فرض : USDTIRT
نمونه: BTCIRT
stringrequiredpair
تعداد محدودیتی برای تعداد سفارشات نمایش داده شده
مقدار پیش فرض : 20
محدوده مجاز: 1 الی 100
integerlimit
Orderbook
/v1/services/trade/p2p/orderbook
GET
RESULT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
{
"code": 200,
"success": true,
"message": "عملیات موفقیت آمیز بود",
"result": {
"symbol": "USDTIRT",
"market_buy_percent": "45.89",
"last_price": "78984",
"last_price_usdt": "1",
"last_update": "2024-12-24 08:25:25",
"bids": [
[
"78300",
"235.91"
],
[
"78285",
"1816.85"
],
[
"78260",
"648.61"
],
[
"78210",
"686.87"
],
[
"78186",
"1903.34"
]
],
"asks": [
[
"78984",
"1722.09"
],
[
"79000",
"66.08"
],
[
"79004",
"1734.26"
],
[
"79039",
"1482.54"
],
[
"79065",
"8.61"
]
]
}
}احراز هویت
برای استفاده از API ارزینجا، ابتدا وارد پنل کاربری شوید و به بخش مدیریت API در منوی حساب کاربری دسترسی پیدا کنید. در این بخش می‌توانید کلیدهای API موردنیاز خود شامل API Key و Secret Key را ایجاد کنید. این کلیدها برای تولید امضای دیجیتال (HMAC) و احراز هویت درخواست‌های خصوصی (Private) استفاده می‌شوند.
برای ارسال درخواست به دسته‌بندی خصوصی، لازم است پارامترهای زیر در هدر درخواست گنجانده شوند:
- X-ARZ-API-KEY: کلید API که هنگام ایجاد کلید دریافت شده است.
- X-ARZ-SIGN: امضای دیجیتال HMAC که از ترکیب API Key، Secret Key، و اطلاعات درخواست (مانند زمان و داده‌های مرتبط) تولید می‌شود.
- X-ARZ-TIMESTAMP: زمان ارسال درخواست به صورت میلی‌ثانیه برای همگام‌سازی زمانی.
- X-ARZ-RECV-WINDOW: بازه زمانی مجاز برای اعتبار درخواست، به صورت میلی‌ثانیه.
این ساختار به شما امکان می‌دهد با اطمینان از امنیت و یکپارچگی داده‌ها، درخواست‌های خود را ارسال کرده و ارتباط مطمئنی با سرویس برقرار کنید. همچنین در طراحی کد خود، مطمئن شوید که مقادیر فوق به درستی تولید و به همراه درخواست ارسال می‌شوند تا درخواست شما مورد تایید سرور قرار گیرد.
نمونه کد ساخت امضا در جاوا اسکریپت (JavaScript)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// Importing CryptoJS
const CryptoJS = require('crypto-js');
// اطلاعات مورد نیاز برای امضا
const API_KEY = pm.environment.get("API_KEY");
const API_SECRET = pm.environment.get("API_SECRET");
const timestamp = Date.now();
const recvWindow = 1000 * 60 * 60 * 24;
// مقدار body و query string برای امضا
let method = pm.request.method;
let queryString = '';
let body = '';
// چک کردن نوع متد برای تنظیم queryString و body
if (method === 'GET') {
queryString = pm.request.url.query.toString();
} else if (method === 'POST' || method === 'PUT') {
body = JSON.stringify(pm.request.body ? pm.request.body.formdata.toObject() : {});
}
// ساخت رشته آماده برای امضا
const preparedString = method === 'GET'
? `${timestamp}${API_KEY}${recvWindow}${queryString}`
: `${timestamp}${API_KEY}${recvWindow}${body}`;
// ساخت امضا با HMAC-SHA256
const sign = CryptoJS.HmacSHA256(preparedString, API_SECRET).toString(CryptoJS.enc.Hex);
// افزودن سربرگ‌ها به درخواست
pm.request.headers.add({ key: 'X-ARZ-API-KEY', value: API_KEY });
pm.request.headers.add({ key: 'X-ARZ-SIGN', value: sign });
pm.request.headers.add({ key: 'X-ARZ-TIMESTAMP', value: timestamp.toString() });
pm.request.headers.add({ key: 'X-ARZ-RECV-WINDOW', value: recvWindow.toString() });سرویس های اختصاصی
موجودی کیف پول (Wallet Balance)
این درخواست برای دریافت موجودی کیف پول کاربر در بازار ارزینجا استفاده می‌شود.
پارامترها
نماد ارز مورد نظر
نمونه: BTC
این نمادها را می‌توانید از درخواست Currency List دریافت کنید.
stringsymbol
Wallet Balance
/v1/services/wallet/balances
GET
RESULT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
{
"code": 200,
"success": true,
"message": "عملیات موفقیت آمیز بود",
"result": [
{
"currency_id": 258,
"symbol": "BTC",
"slug": "bitcoin",
"position": 10,
"title": "بیت کوین",
"is_fiat": 0,
"balance_decimal": "6",
"balance": "2.011676",
"balance_freeze": "0",
"balance_available": "2.011676",
"estimated_usdt": "188153.04",
"is_depositable": 1,
"is_withdrawable": 1,
"otc_tradeable": 1,
"p2p_tradeable": 1,
"p2p_pair": "BTCIRT",
"networks": null
}
],
"pagination": {
"total": 1,
"count": 1,
"per_page": 15,
"current_page": 1,
"total_pages": 1,
"links": {}
}
}سابقه تراکنش‌ها (Transaction History)
این درخواست برای دریافت سابقه تراکنش‌های انجام شده در بازار ارزینجا استفاده می‌شود.
پارامترها
نشان دهنده جنس دارایی ها می باشد که شامل دو نوع crypto, fiat می باشد.
stringrequiredtype
نوع عملیات مورد نظر که شامل دو نوع deposit, withdraw می باشد.
stringrequiredoperation
تاریخ شروع مورد نظر برای جستجوی تراکنش ها
نمونه: 01-01-2024
stringfrom_date
تاریخ پایان مورد نظر برای جستجوی تراکنش ها
نمونه: 31-12-2024
حداکثر فاصله زمانی بین دو تاریخ یک سال می باشد.
stringto_date
شناسه ارز مورد نظر
نمونه: 258
مقدار شناسه را میتواند از درخواست Currency List دریافت کنید.
integercurrency_id
شماره صفحه مورد نظر
مقدار پیش فرض: 1
محدوده مجاز: 1 الی supported_max_page
integerpage
تعداد تراکنش های نمایش داده شده در هر صفحه
مقدار پیش فرض: 10
محدوده مجاز: 1 الی 100
integerper_page
Transaction History
/v1/services/wallet/transactions
GET
RESULT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
{
"code": 200,
"success": true,
"message": "عملیات موفقیت آمیز بود",
"result": [
{
"id": "CD-251",
"operation": "deposit",
"amount": "1.0000000000",
"status": "1",
"date": "2024-12-28 23:47:29",
"currency_symbol": "BTC",
"currency_title": "بیت کوین",
"is_internal": 1
},
{
"id": "CD-250",
"operation": "deposit",
"amount": "1.0000000000",
"status": "1",
"date": "2024-12-28 23:43:38",
"currency_symbol": "BTC",
"currency_title": "بیت کوین",
"is_internal": 1
},
{
"id": "CD-231",
"operation": "deposit",
"amount": "10.0000000000",
"status": "1",
"date": "2024-12-10 15:23:58",
"currency_symbol": "USDT",
"currency_title": "تتر",
"is_internal": 1
}
],
"pagination": {
"total": 3,
"count": 3,
"per_page": 15,
"current_page": 1,
"total_pages": 1,
"links": {}
}
}جزئیات تراکنش (Transaction Detail)
این درخواست برای دریافت جزئیات تراکنش‌های انجام شده در بازار ارزینجا استفاده می‌شود.
پارامترها
شناسه تراکنش مورد نظر
نمونه: CD-251
اطلاعات شناسه تراکنش را می‌توانید از درخواست Transaction History دریافت کنید.
stringrequiredid
Transaction Detail
/v1/services/wallet/transaction/:id
GET
RESULT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
"code": 200,
"success": true,
"message": "عملیات موفقیت آمیز بود",
"result": {
"id": "CD-209",
"operation": "deposit",
"currency_title": "بیت کوین",
"currency_symbol": "BTC",
"amount": "0.00022",
"amount_type": 1,
"network": null,
"txid": "Internal Transfer 130",
"address": "09183334445",
"tag": null,
"status": "1",
"is_internal": true,
"created_at": "2024-10-23 14:15:35",
"confirmed_at": "2024-10-23 14:15:35",
"ticket_id": null,
"ticket_default_subject_id": 1,
"ticket_department_id": 1
}
}لیست سفارشات (Order List)
این درخواست برای دریافت لیست سفارشات انجام شده در بازار ارزینجا استفاده می‌شود.
پارامترها
جفت ارز مورد نظر
مقدار پیش فرض: all
نمونه: BTCIRT, BTC, IRT
stringpair
نوع سفارش مورد نظر
مقدار پیش فرض: all
مقادیر مجاز: CONVEERT, OTC, P2P
stringorder_type
نوع قیمت گذاری سفارش مورد نظر
مقدار پیش فرض: all
مقادیر مجاز: MARKET, LIMIT
stringtype
نوع سفارش مورد نظر
مقدار پیش فرض: all
مقادیر مجاز: BUY, SELL
stringside
تاریخ شروع مورد نظر برای جستجوی سفارش ها
نمونه: 01-01-2024
stringfrom_date
تاریخ پایان مورد نظر برای جستجوی سفارش ها
نمونه: 31-12-2024
حداکثر فاصله زمانی بین دو تاریخ یک سال می باشد.
stringto_date
Order List
/v1/services/trade/order-history
GET
RESULT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
{
"code": 200,
"success": true,
"message": "عملیات موفقیت آمیز بود",
"result": [
{
"order_id": 14327760,
"order_type": "CONVERT",
"base_asset": "BTC",
"quote_asset": "USDT",
"side": "BUY",
"type": "MARKET",
"amount": "0.00634",
"amount_unit": "BTC",
"price": "100819.9 USDT",
"total": "639.47",
"trade_fill_percent": 100,
"filled_status": "full_filled",
"status": 1,
"created_at": "2024-12-12 12:02:07"
},
{
"order_id": 14327759,
"order_type": "OTC",
"base_asset": "BTC",
"quote_asset": "IRT",
"side": "SELL",
"type": "MARKET",
"amount": "0.00244",
"amount_unit": "BTC",
"price": "7436983611 IRT",
"total": "18146240",
"trade_fill_percent": 100,
"filled_status": "full_filled",
"status": 1,
"created_at": "2024-12-12 12:02:00"
},
{
"order_id": 14327758,
"order_type": "OTC",
"base_asset": "BTC",
"quote_asset": "IRT",
"side": "BUY",
"type": "MARKET",
"amount": "0.00985",
"amount_unit": "BTC",
"price": "7436696665 IRT",
"total": "73250000",
"trade_fill_percent": 100,
"filled_status": "full_filled",
"status": 1,
"created_at": "2024-12-12 12:01:53"
},
{
"order_id": 14327757,
"order_type": "CONVERT",
"base_asset": "BTC",
"quote_asset": "USDT",
"side": "BUY",
"type": "MARKET",
"amount": "0.00318",
"amount_unit": "BTC",
"price": "0 USDT",
"total": "319.73",
"trade_fill_percent": 0,
"filled_status": "not_filled",
"status": 1,
"created_at": "2024-12-12 11:22:13"
},
{
"order_id": 14327752,
"order_type": "CONVERT",
"base_asset": "BTC",
"quote_asset": "USDT",
"side": "BUY",
"type": "MARKET",
"amount": "0.00635",
"amount_unit": "BTC",
"price": "0 USDT",
"total": "639.47",
"trade_fill_percent": 0,
"filled_status": "not_filled",
"status": 1,
"created_at": "2024-12-12 11:10:21"
},
{
"order_id": 14327751,
"order_type": "CONVERT",
"base_asset": "BTC",
"quote_asset": "USDT",
"side": "BUY",
"type": "MARKET",
"amount": "0.00635",
"amount_unit": "BTC",
"price": "0 USDT",
"total": "639.47",
"trade_fill_percent": 0,
"filled_status": "not_filled",
"status": 1,
"created_at": "2024-12-12 11:10:19"
},
{
"order_id": 14327750,
"order_type": "CONVERT",
"base_asset": "BTC",
"quote_asset": "USDT",
"side": "BUY",
"type": "MARKET",
"amount": "0.00635",
"amount_unit": "BTC",
"price": "0 USDT",
"total": "639.47",
"trade_fill_percent": 0,
"filled_status": "not_filled",
"status": 1,
"created_at": "2024-12-12 11:10:17"
},
{
"order_id": 14327749,
"order_type": "CONVERT",
"base_asset": "BTC",
"quote_asset": "USDT",
"side": "BUY",
"type": "MARKET",
"amount": "0.00635",
"amount_unit": "BTC",
"price": "0 USDT",
"total": "639.47",
"trade_fill_percent": 0,
"filled_status": "not_filled",
"status": 1,
"created_at": "2024-12-12 11:10:12"
},
{
"order_id": 14327747,
"order_type": "CONVERT",
"base_asset": "SOL",
"quote_asset": "USDT",
"side": "BUY",
"type": "MARKET",
"amount": "2.771",
"amount_unit": "SOL",
"price": "0 USDT",
"total": "639.47",
"trade_fill_percent": 0,
"filled_status": "not_filled",
"status": 1,
"created_at": "2024-12-12 11:08:14"
},
{
"order_id": 14327746,
"order_type": "CONVERT",
"base_asset": "SOL",
"quote_asset": "USDT",
"side": "BUY",
"type": "MARKET",
"amount": "2.772",
"amount_unit": "SOL",
"price": "0 USDT",
"total": "639.47",
"trade_fill_percent": 0,
"filled_status": "not_filled",
"status": 1,
"created_at": "2024-12-12 11:08:13"
}
],
"pagination": {
"total": 52,
"count": 10,
"per_page": 10,
"current_page": 1,
"total_pages": 6,
"links": {
"next": "{{BASE_URL}}/v1/services/trade/order-history?page=2"
}
}
}جزئیات سفارش (Order Detail)
این درخواست برای دریافت جزئیات سفارش‌های انجام شده در بازار ارزینجا استفاده می‌شود.
پارامترها
شناسه سفارش مورد نظر
نمونه: 14327760
اطلاعات شناسه سفارش را می‌توانید از درخواست Order List دریافت کنید.
integerrequiredid
Order Detail
/v1/services/trade/order/:id
GET
RESULT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
{
"code": 200,
"success": true,
"message": "عملیات موفقیت آمیز بود",
"result": {
"order_id": 11007050,
"base_asset": "TON",
"quote_asset": "IRT",
"from_asset_symbol": "IRT",
"from_asset_amount": "375000000",
"from_asset_title": "تومان",
"to_asset_symbol": "TON",
"to_asset_amount": "1063.36",
"to_asset_title": "دِ اُپن نتورک",
"type": "MARKET",
"side": "BUY",
"price": "352652",
"price_unit": "IRT",
"commission": "7.01",
"commission_asset": "TON",
"commission_percent": "0.66",
"commission_discount": "0.04",
"total_qty": "375000000",
"trade_fill_amount": "1063.36986845",
"receiving_qty": "1056.35",
"status": 1,
"created_at": "2024-10-24 21:03:12",
"ticket_id": null,
"ticket_default_subject_id": "1",
"ticket_department_id": 1,
"trade_fill_percent": "100",
"filled_status": "full_filled",
"trade_count": 1,
"trades": [
{
"trade_create_at": "2024-10-24 21:03:12",
"trade_qty": "1063.36986845",
"trade_price": "352652",
"trade_total": "375000000",
"trade_commission": "7.01"
}
]
}
}دریافت آدرس کیف پول واریز رمزارز
این درخواست برای دریافت آدرس کیف پول برای واریز رمزارز به کیف پول ارزینجا استفاده می‌شود.
پارامترها
شناسه ارز مورد نظر
نمونه: 258
اطلاعات شناسه ارز را می‌توانید از درخواست Currency List دریافت کنید.
integerrequiredcurrency_id
شناسه شبکه مورد نظر
نمونه: 1
اطلاعات شناسه شبکه را می‌توانید از درخواست Balances دریافت کنید.
integerrequiredpb_id
Deposit Address
/v1/services/wallet/get-deposit-address
POST
RESULT
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"code": 200,
"success": true,
"message": "عملیات موفقیت آمیز بود",
"result": {
"deposit_address": "3CMiW57g7oAEc5Yju9ZxoM7Nye7K7LMRp9",
"deposit_tag": null,
"address_type": "dedicated",
"expired_at": null,
"expired_at_unix": null,
"expired_at_minutes": null
}
}ثبت درخواست معامله سریع (Instant Trade)
این درخواست برای ثبت درخواست معامله سریع با ارزینجا استفاده می‌شود. شامل سه نوع عملیات خرید، فروش و تبدیل می‌شود.
پارامترها
جفت ارز مورد نظر
درخواست های تبدیل طرف دوم معامله همیشه USDT می باشد.
درخواست های خرید و فروش طرف دوم جفت ارز همیشه IRT می باشد.
نمونه: BTCIRT
stringrequiredpair
نوع قیمت گذاری شما برای معامله را مشخص می کند.
توجه داشته باشید ارزهایی که امکان معامله در مارکت ارزینجا را دارند (باتوجه) به اندپوینت Markets Pair List) امکان ثبت سفارش LIMIT ندارند.
مقدار پیش فرض: MARKET
مقادیر مجاز: MARKET, LIMIT
stringrequiredtype
نوع معامله شما را مشخص میکند.
مقدار پیش فرض: BUY
مقادیر مجاز: BUY, SELL
stringrequiredside
مقدار ارز مورد نظر برای معامله
نمونه: 0.001
در دو ساختار int, float مقدار دهی می شود. و بازه عددی مجاز برای هر ارز و همینطور حداکثر رقم اعشار مجاز برای ثبت سفارش از طریق اندپوینت All Market مشخص می شود.
stringrequiredqty
در صورتی که مقدار ارسالی بر اساس ارز دوم باشد این پارامتر مقدار ۱ میگیرد.
به عنوان مثال در خرید ارز USDT، اگر مقدار خرید 1 میلیون تومان باشد بایستی پارامتر qty:1000000 و پارامتر is_qoute:1 باشد.
مقادیر مجاز: 0و 1.
integerrequiredis_qoute
قیمت مورد نظر برای معامله
نمونه: 100000000
در دو ساختار int, float مقدار دهی می شود. و بازه عددی مجاز برای هر ارز و همینطور حداکثر رقم اعشار مجاز برای ثبت سفارش از طریق اندپوینت All Market مشخص می شود.
numberuser_price
Instant Trade
/v1/services/trade/otc/order
POST
RESULT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
"code": 200,
"success": true,
"message": "عملیات موفقیت آمیز بود",
"result": {
"order_id": 14332143,
"from_asset_symbol": "IRT",
"from_asset_amount": "7324884",
"from_asset_title": "تومان",
"to_asset_symbol": "BTC",
"to_asset_amount": "0.001",
"to_asset_title": "بیت کوین",
"type": "MARKET",
"side": "BUY",
"price": "0",
"price_unit": "IRT",
"commission": "0.000006",
"commission_asset": "BTC",
"commission_percent": "0.66",
"commission_discount": "0.04",
"total_qty": "0.000993",
"status": 1
}
}لغو سفارش معاله سریع (Cancel Instant Trade)
این درخواست برای لغو سفارش معامله سریع با ارزینجا استفاده می‌شود.
پارامترها
شناسه سفارش مورد نظر
نمونه: 14332143
اطلاعات شناسه سفارش را می‌توانید از درخواست Instant Trade دریافت کنید.
integerrequiredorder_id
Cancel Instant Trade
/v1/services/trade/otc/cancel
POST
RESULT
1
2
3
4
5
6
{
"code": 200,
"success": true,
"message": "عملیات موفقیت آمیز بود",
"result": []
}ثبت معامله پیشرفته (Advance Trade) در بازار معاملاتی ارزینجا
این درخواست برای ثبت معامله پیشرفته در بازار معاملاتی ارزینجا استفاده می‌شود.
پارامترها
جفت ارز مورد نظر
نمونه: BTCIRT
stringrequiredpair
نوع قیمت گذاری شما برای معامله را مشخص میکند.
مقدار پیش فرض: MARKET
مقادیر مجاز: MARKET, LIMIT
stringrequiredtype
نوع معامله شما را مشخص میکند.
مقدار پیش فرض: BUY
مقادیر مجاز: BUY, SELL
stringrequiredside
مقدار ارز مورد نظر برای معامله
نمونه: 0.001
در دو ساختار int, float مقدار دهی می شود. و بازه عددی مجاز برای هر ارز و همینطور حداکثر رقم اعشار مجاز برای ثبت سفارش از طریق اندپوینت All Market مشخص می شود.
stringrequiredqty
قیمت مورد نظر برای معامله
نمونه: 100000000
در دو ساختار int, float مقدار دهی می شود. و بازه عددی مجاز برای هر ارز و همینطور حداکثر رقم اعشار مجاز برای ثبت سفارش از طریق اندپوینت All Market مشخص می شود.
numberuser_price
Advance Trade
/v1/services/trade/p2p/order
POST
RESULT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
"code": 200,
"success": true,
"message": "عملیات موفقیت آمیز بود",
"result": {
"order_id": 14332144,
"from_asset_symbol": "IRT",
"from_asset_amount": "15304635",
"from_asset_title": "تومان",
"to_asset_symbol": "USDT",
"to_asset_amount": "252.09",
"to_asset_title": "تتر",
"type": "LIMIT",
"side": "BUY",
"price": "60711",
"price_unit": "IRT",
"commission": "0.453762",
"commission_asset": "USDT",
"commission_percent": "0.18",
"commission_discount": "0",
"total_qty": "251.63",
"status": 0
}
}لفو سفارش معامله پیشرفته (Cancel Advance Trade)
این درخواست برای لغو سفارش معامله پیشرفته با ارزینجا استفاده می‌شود.
پارامترها
شناسه سفارش مورد نظر
نمونه: 14332144
اطلاعات شناسه سفارش را می‌توانید از درخواست Advance Trade دریافت کنید.
integerrequiredorder_id
Cancel Advance Trade
/v1/services/trade/p2p/cancel
POST
RESULT
1
2
3
4
5
6
{
"code": 200,
"success": true,
"message": "عملیات موفقیت آمیز بود",
"result": []
}