Token

토큰 관련 API

지원 토큰 목록

post

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

/tikkly-b2c/token/supported

시스템에서 지원하는 모든 토큰 목록을 조회합니다

Header parameters

x-api-keystringRequired

API Key

Default: TEST_API_KEYExample: TEST_API_KEY

Responses

200

토큰 목록 조회 성공

application/json

401

인증 실패

post

/tikkly-b2c/token/supported

HTTPcURLJavaScriptPython

POST /tikkly-b2c/token/supported HTTP/1.1
Host: api-b2c.tikkly.io
x-api-key: TEST_API_KEY
Accept: */*

{
  "statusCode": 200,
  "message": "Success",
  "data": [
    {
      "id": 1,
      "symbol": "BTC",
      "name": "Bitcoin",
      "decimals": 8,
      "cmcId": 1,
      "coingeckoId": "bitcoin",
      "binanceSymbol": "BTCUSDT",
      "isActive": true
    }
  ]
}

토큰 가격 조회

post

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

/tikkly-b2c/token/token-price/{symbol}

특정 토큰의 현재 가격을 조회합니다

Path parameters

symbolstringRequired

토큰 심볼

Example: BTC

Header parameters

x-api-keystringRequired

API Key

Default: TEST_API_KEYExample: TEST_API_KEY

Body

application/json

quotestringOptional

기준 통화

Default: USDTExample: USDT

invalidatebooleanOptional

캐시 무효화 여부

Default: false

Responses

200

가격 조회 성공

application/json

401

인증 실패

404

토큰을 찾을 수 없음

post

/tikkly-b2c/token/token-price/{symbol}

HTTPcURLJavaScriptPython

POST /tikkly-b2c/token/token-price/{symbol} HTTP/1.1
Host: api-b2c.tikkly.io
x-api-key: TEST_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "quote": "USDT",
  "invalidate": false
}

{
  "statusCode": 200,
  "message": "Success",
  "data": {
    "symbol": "BTC",
    "price": 45000.5,
    "quote": "USDT",
    "updatedAt": "2024-01-15T10:30:00Z"
  }
}

사용자 토큰 잔액 조회

post

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

/tikkly-b2c/token/user-balances

UUID로 사용자의 토큰 잔액을 조회합니다

Header parameters

x-api-keystringRequired

API Key

Default: TEST_API_KEYExample: TEST_API_KEY

Body

application/json

uuidstringRequired

사용자 UUID

Default: 40115395-195e-4c14-b5f4-261f13da353eExample: 40115395-195e-4c14-b5f4-261f13da353e

Responses

200

잔액 조회 성공

application/json

401

인증 실패

404

사용자를 찾을 수 없음

post

/tikkly-b2c/token/user-balances

HTTPcURLJavaScriptPython

POST /tikkly-b2c/token/user-balances HTTP/1.1
Host: api-b2c.tikkly.io
x-api-key: TEST_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "uuid": "40115395-195e-4c14-b5f4-261f13da353e"
}

{
  "statusCode": 200,
  "message": "Success",
  "data": [
    {
      "symbol": "BTC",
      "balance": 1.23456789,
      "decimals": 18
    }
  ]
}

토큰 가격 캔들 차트

post

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

/tikkly-b2c/token/token-price-candles/{symbol}

특정 토큰의 가격 캔들 차트 데이터를 조회합니다

Path parameters

symbolstringRequired

토큰 심볼

Example: BTC

Header parameters

x-api-keystringRequired

API Key

Default: TEST_API_KEYExample: TEST_API_KEY

Body

application/json

intervalstring · enumRequired

캔들 간격

Example: 1hPossible values:

limitinteger · min: 1 · max: 1000Optional

반환할 캔들 개수

Default: 100

quotestringOptional

기준 통화

Default: USDTExample: USDT

Responses

200

캔들 데이터 조회 성공

application/json

401

인증 실패

404

토큰을 찾을 수 없음

post

/tikkly-b2c/token/token-price-candles/{symbol}

HTTPcURLJavaScriptPython

POST /tikkly-b2c/token/token-price-candles/{symbol} HTTP/1.1
Host: api-b2c.tikkly.io
x-api-key: TEST_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "interval": "1h",
  "limit": 100,
  "quote": "USDT"
}

{
  "statusCode": 200,
  "message": "Success",
  "data": [
    {
      "time": 1704067200000,
      "open": 44000.5,
      "high": 45000,
      "low": 43500,
      "close": 44500.75,
      "volume": 1234.56789
    }
  ]
}