정보/잔액

잔액

통화별 잔액과 함께 가맹점 계정 목록을 조회합니다.

Balance endpoint는 프로젝트 내 모든 가맹점 계정의 사용 가능한 잔액, USD 환산 금액 및 잠긴 금액을 반환합니다.

잔액 조회

가맹점 계정 목록을 반환합니다. 요청 본문이 없으므로 서명은 빈 문자열을 기준으로 계산합니다.

응답 필드

result의 각 계정에는 다음이 포함됩니다:

필드	타입	설명
`uuid`	string	계정 UUID
`status`	string	계정 상태 (`active`, `disabled`)
`currency_code`	string	계정 통화
`balance`	decimal	사용 가능한 잔액
`balance_usd`	decimal	USD로 환산한 사용 가능 잔액
`locked_balance`	decimal	AML로 인해 잠긴 금액

응답 예시

JSON

{
  "state": 0,
  "result": [
    {
      "uuid": "abc123-def456-...",
      "status": "active",
      "currency_code": "USDT",
      "balance": "1250.50",
      "balance_usd": "1250.50",
      "locked_balance": "0.00"
    },
    {
      "uuid": "def456-abc789-...",
      "status": "active",
      "currency_code": "BTC",
      "balance": "0.01320000",
      "balance_usd": "1251.20",
      "locked_balance": "0.00000000"
    }
  ]
}

Credentials

Project UUIDAPI key

RequestGET/v1/balance

curl -X GET https://api.2328.io/api/v1/balance \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyShop/1.0 (+https://myshop.example)" \
  -H "project: YOUR_PROJECT_UUID" \
  -H "sign: YOUR_HMAC_SIGNATURE"

Response

Click Try it to see the response here.