Exchange

포인트 교환 관련 API

포인트를 코인으로 전환

post

https://api-b2c.tikkly.iohttps://api.tikkly.comhttp://localhost:8081

/tikkly-b2c/exchange/convert-point-to-coin

포인트를 암호화폐로 전환합니다

Header parameters

x-api-keystringRequired

API Key

Default: TEST_API_KEYExample: TEST_API_KEY

Body

application/json

uuidstringRequired

사용자 UUID

Example: 40115395-195e-4c14-b5f4-261f13da353e

symbolstringRequired

토큰 심볼

Example: BTC

cexTypestringRequired

거래소 타입

Example: binance

pointAmountstringRequired

포인트 수량

Example: 100

pointTypestringRequired

포인트 타입

Example: OK-CASHBAG

Responses

200

전환 성공

application/json

401

인증 실패

post

/tikkly-b2c/exchange/convert-point-to-coin

HTTPcURLJavaScriptPython

POST /tikkly-b2c/exchange/convert-point-to-coin HTTP/1.1
Host: api-b2c.tikkly.io
x-api-key: TEST_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 127

{
  "uuid": "40115395-195e-4c14-b5f4-261f13da353e",
  "symbol": "BTC",
  "cexType": "binance",
  "pointAmount": "100",
  "pointType": "OK-CASHBAG"
}

{
  "statusCode": 200,
  "message": "Success",
  "data": {
    "orderId": "123456789"
  }
}

전환 견적 조회

post

https://api-b2c.tikkly.iohttps://api.tikkly.comhttp://localhost:8081

/tikkly-b2c/exchange/convert-quote

포인트를 코인으로 전환할 때의 예상 견적을 조회합니다

Header parameters

x-api-keystringRequired

API Key

Default: TEST_API_KEYExample: TEST_API_KEY

Body

application/json

symbolstringRequired

토큰 심볼

Example: BTC

cexTypestringRequired

거래소 타입

Example: binance

pointAmountstringRequired

포인트 수량

Example: 100

pointTypestringRequired

포인트 타입

Example: OK-CASHBAG

Responses

200

견적 조회 성공

application/json

401

인증 실패

post

/tikkly-b2c/exchange/convert-quote

HTTPcURLJavaScriptPython

POST /tikkly-b2c/exchange/convert-quote HTTP/1.1
Host: api-b2c.tikkly.io
x-api-key: TEST_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "symbol": "BTC",
  "cexType": "binance",
  "pointAmount": "100",
  "pointType": "OK-CASHBAG"
}

{
  "statusCode": 200,
  "message": "Success",
  "data": {
    "fromAsset": "USDT",
    "toAsset": "BTC",
    "fromAmount": "100",
    "toAmount": "0.002",
    "ratio": "50000",
    "price": "50000"
  }
}

전환 내역 조회

post

https://api-b2c.tikkly.iohttps://api.tikkly.comhttp://localhost:8081

/tikkly-b2c/exchange/convert-quote-history

사용자의 포인트 전환 내역을 조회합니다

Header parameters

x-api-keystringRequired

API Key

Default: TEST_API_KEYExample: TEST_API_KEY

Body

application/json

uuidstringRequired

사용자 UUID

Example: 40115395-195e-4c14-b5f4-261f13da353e

sincenumberOptional

시작 시간 (Unix timestamp, 0 = 전체)

Example: 0

untilnumberOptional

종료 시간 (Unix timestamp, 0 = 전체)

Example: 0

Responses

200

내역 조회 성공

application/json

401

인증 실패

post

/tikkly-b2c/exchange/convert-quote-history

HTTPcURLJavaScriptPython

POST /tikkly-b2c/exchange/convert-quote-history HTTP/1.1
Host: api-b2c.tikkly.io
x-api-key: TEST_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "uuid": "40115395-195e-4c14-b5f4-261f13da353e",
  "since": 0,
  "until": 0
}

{
  "statusCode": 200,
  "message": "Success",
  "data": [
    {
      "id": 1,
      "orderId": "123456789",
      "pointType": "OK-CASHBAG",
      "pointAmount": "100",
      "fromAsset": "USDT",
      "toAsset": "BTC",
      "fromAmount": "100",
      "toAmount": "0.002",
      "status": "COMPLETED",
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ]
}