get https://api.inexcoin.com/v1/trades/history
회원의 체결(거래완료) 정보를 제공합니다.
Resonse
| 필드 | 설명 | 타입 |
|---|---|---|
| amount | 거래금액 volume * price | BigDecimal |
| application_name | 어플리케이션 이름 (app, web, webapp, api) | String |
| base_unit | 거래 코인 유닛 | String |
| currency | 거래 통화 | String |
| event_at | 이벤트 시간 ( 체결시간 ) | String |
| event_type | bid: 매수, ask: 매도, deposit:입금, withdraw:출금 | String |
| event_uuid | 저장 uuid (event uuid) 사용 안해도 됩니다. 삭제 예정 | String |
| fiat_currency | fiat 통화 | String |
| fiat_amount | fiat 거래금액 | BigDecimal |
| fiat_settlement_amount | fiat 정산금액 | BigDecimal |
| fiat_unit_price | fiat 단일 가격 | BigDecimal |
| fee | 수수료 | BigDecimal |
| market | 마켓 ( quote_unit + base_unit ) USDT-ETH | String |
| price | 거래가 | BigDecimal |
| quote_unit | 거래 통화 유닛 | String |
| settlement_amount | 정산 금액 | BigDecimal |
| order_type | 주문 유형 ( limit, market, stop ) | String |
| order_at | 주문시간 | String |
| uuid | 고유 uuid | String |
| volume | 체결 수량 | BigDecimal |
PageSize : 30건
Pagination: uuid 와 after 값으로 페이지 네이션 처리가 필요합니다. 아래 예시를 참고 바랍니다.
from , to 값이 잘못되거나 미 설정일 경우 ( 과거 7일 ~ 현재 ) 기간으로 조회합니다.
거래내역의 시간 순서는 가장 최근 내역 순으로 내려옵니다.
예시)
- 최초 요청 GET {{baseUrl}}/v1/trades/history?symbol=XRP&from=2021-09-19T10%3A44%3A04.000%2B0900&to=2023-12-21T10%3A44%3A04.000%2B0900
응답
{
"success": true,
"code": 0,
"message": "Operation succeeded.",
"data": [
{
"amount": 0.104,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-29T07:42:01.000+0000",
"event_type": "ask",
"event_uuid": "86689f1e-e767-4e1f-bc63-e1a2894f3149",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1402018,
"fee": 0.000156,
"market": "USDT-ETH",
"price": 1040.0,
"quote_unit": "USDT",
"settlement_amount": 0.103844,
"service_code": null,
"order_at": "2024-03-29T07:42:01.600+0000",
"order_type": "market",
"transaction_type": "default",
"uuid": "a8da0fdb-fb1c-414c-9fe8-0bad61e321fd",
"volume": 0.00010
},
{
"amount": 0.169,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-29T07:32:10.000+0000",
"event_type": "bid",
"event_uuid": "ea6a77bf-155a-4f46-a458-53e42eb579ef",
"fiat_currency": "KRW",
"fiat_amount": 228,
"fiat_settlement_amount": 228,
"fiat_unit_price": 2278279,
"fee": 0.0002535,
"market": "USDT-ETH",
"price": 1690.0,
"quote_unit": "USDT",
"settlement_amount": 0.1692535,
"service_code": null,
"order_at": "2024-03-29T07:32:09.898+0000",
"order_type": "limit",
"transaction_type": "default",
"uuid": "f8fbe12d-99a4-41da-a467-3742ddc71aa0",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T18:14:21.000+0900",
"event_type": "bid",
"event_uuid": "84b3da68-9e18-491d-a4fe-b57f1ca55e9a",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1402493,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T18:14:21.210+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "2d2925c6-8d70-410b-94b9-4f66228a8022",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T18:14:21.000+0900",
"event_type": "bid",
"event_uuid": "84b3da68-9e18-491d-a4fe-b57f1ca55e9a",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1399794,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T18:14:21.210+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "19af1fb3-f47d-439d-9726-5c8c693dba83",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T17:05:21.000+0900",
"event_type": "bid",
"event_uuid": "9bdca534-3c49-424f-9ffd-051bfcf9353b",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1398595,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T17:05:21.185+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "ed87d5b3-c0f7-4198-84df-1dfb4301ddee",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T17:05:21.000+0900",
"event_type": "bid",
"event_uuid": "9bdca534-3c49-424f-9ffd-051bfcf9353b",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1398595,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T17:05:21.185+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "88627f04-39e8-4609-a37b-f76ef0ded1fc",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T17:04:31.000+0900",
"event_type": "bid",
"event_uuid": "fd1a90d3-125f-4c15-af02-f31c01310fba",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1398595,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T17:04:30.664+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "a645de17-3d64-40be-87ab-84c721850f94",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T17:04:31.000+0900",
"event_type": "bid",
"event_uuid": "fd1a90d3-125f-4c15-af02-f31c01310fba",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1398595,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T17:04:30.664+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "1df43fd6-a7aa-497b-bc81-ea8d6ded40cc",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T17:03:31.000+0900",
"event_type": "bid",
"event_uuid": "9b48a035-ef9d-4986-ba0c-eb6d728dc52a",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1398595,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T17:03:31.316+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "b84a3cd0-9390-4815-892c-e514695ac1d0",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T17:03:31.000+0900",
"event_type": "bid",
"event_uuid": "9b48a035-ef9d-4986-ba0c-eb6d728dc52a",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1398595,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T17:03:31.316+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "1a9f0376-0919-4580-b896-8f3ac961926d",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T16:52:05.000+0900",
"event_type": "bid",
"event_uuid": "d0b3a1b2-ad77-493d-afa0-22b75a573e4f",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1396863,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T16:52:04.552+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "7e4e3275-fab3-4080-bec6-34918a7135eb",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T16:52:05.000+0900",
"event_type": "bid",
"event_uuid": "d0b3a1b2-ad77-493d-afa0-22b75a573e4f",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1396863,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T16:52:04.552+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "0055ff28-81b2-4547-9410-6f4f37103d39",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T16:47:26.000+0900",
"event_type": "bid",
"event_uuid": "c9633f5b-7207-4519-94fb-16188d3c11b9",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1396863,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T16:47:26.103+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "80f451d9-8b9d-492a-92cf-3ecfaed6d535",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T16:47:26.000+0900",
"event_type": "bid",
"event_uuid": "c9633f5b-7207-4519-94fb-16188d3c11b9",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1396863,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T16:47:26.103+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "0a12f68b-526f-4dca-b888-443eb3b68f4a",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T16:45:40.000+0900",
"event_type": "bid",
"event_uuid": "977dbfee-d9e5-4e51-a17f-263643c409ef",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1396863,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T16:45:39.919+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "a253aa1a-5d69-4442-9c72-411887d3af11",
"volume": 0.00010
},
{
"amount": 0.1037,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T16:45:40.000+0900",
"event_type": "bid",
"event_uuid": "977dbfee-d9e5-4e51-a17f-263643c409ef",
"fiat_currency": "KRW",
"fiat_amount": 140,
"fiat_settlement_amount": 140,
"fiat_unit_price": 1396863,
"fee": 0.00015555,
"market": "USDT-ETH",
"price": 1037,
"quote_unit": "USDT",
"settlement_amount": 0.10385555,
"service_code": null,
"order_at": "2024-03-28T16:45:39.919+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "8643078a-5989-4ce5-8508-905d95a4c6fd",
"volume": 0.00010
},
{
"amount": 71.05,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T00:30:34.000+0000",
"event_type": "ask",
"event_uuid": "65116514-b4a9-4aa3-8cd2-efb84035a071",
"fiat_currency": "KRW",
"fiat_amount": 95938,
"fiat_settlement_amount": 95794,
"fiat_unit_price": 1370545,
"fee": 0.106575,
"market": "USDT-ETH",
"price": 1015,
"quote_unit": "USDT",
"settlement_amount": 70.943425,
"service_code": null,
"order_at": "2024-03-28T00:30:34.545+0000",
"order_type": "limit",
"transaction_type": "default",
"uuid": "83bc8141-9e72-4b98-95f9-81bcbf212326",
"volume": 0.07
},
{
"amount": 71.05,
"application_name": "app",
"base_unit": "ETH",
"currency": "ETH",
"event_at": "2024-03-28T09:30:34.000+0900",
"event_type": "ask",
"event_uuid": "65116514-b4a9-4aa3-8cd2-efb84035a071",
"fiat_currency": "KRW",
"fiat_amount": 95938,
"fiat_settlement_amount": 95794,
"fiat_unit_price": 1370545,
"fee": 0.106575,
"market": "USDT-ETH",
"price": 1015,
"quote_unit": "USDT",
"settlement_amount": 70.943425,
"service_code": null,
"order_at": "2024-03-28T09:30:34.545+0900",
"order_type": "limit",
"transaction_type": "default",
"uuid": "320a7108-7d6c-4f21-8207-8675358e06ea",
"volume": 0.07
}
]
}마지막 항목의 "uuid": "c58a50cf-b012-4fd0-8d28-68e02606d70d" 와 "event_at": "2023-09-08T13:42:30.000+0900" 를 각각 uuid, after 에 설정하여 query param 항목으로 API 요청
- 페이지네이션 요청 {{baseUrl}}/v1/trades/history?symbol=XRP&from=2021-09-19T10%3A44%3A04.000%2B0900&to=2023-12-21T10%3A44%3A04.000%2B0900&after=2023-09-08T13%3A42%3A30.000%2B0900&uuid=c58a50cf-b012-4fd0-8d28-68e02606d70d
다음 페이지 요청시, 첫 페이지네이션 요청과 마찬가지로 마지막 항목의 uuid 와 after(event_at) 을 변경하여 전달해주세요
요청결과가 30건 미만이거나, 0건 일경우 마지막 페이지입니다
사용자의 입력이 변경된 경우 최초 요청으로 초기화 진행해주세요