Exchange

포인트 교환 관련 API

포인트를 코인으로 전환

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

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

Header parameters
x-api-keystringRequired

API Key

Default: TEST_API_KEYExample: TEST_API_KEY
Body
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
post
/tikkly-b2c/exchange/convert-point-to-coin
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
/tikkly-b2c/exchange/convert-quote

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

Header parameters
x-api-keystringRequired

API Key

Default: TEST_API_KEYExample: TEST_API_KEY
Body
symbolstringRequired

토큰 심볼

Example: BTC
cexTypestringRequired

거래소 타입

Example: binance
pointAmountstringRequired

포인트 수량

Example: 100
pointTypestringRequired

포인트 타입

Example: OK-CASHBAG
Responses
200

견적 조회 성공

application/json
post
/tikkly-b2c/exchange/convert-quote
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
/tikkly-b2c/exchange/convert-quote-history

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

Header parameters
x-api-keystringRequired

API Key

Default: TEST_API_KEYExample: TEST_API_KEY
Body
uuidstringRequired

사용자 UUID

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

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

Example: 0
untilnumberOptional

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

Example: 0
Responses
200

내역 조회 성공

application/json
post
/tikkly-b2c/exchange/convert-quote-history
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"
    }
  ]
}
PreviousTokenNextTrading