Bithumb

BithumbClient <: AbstractAPIsClient

Client info.

Required fields

• base_url::String: Base URL for the client.

Optional fields

• public_key::String: Public key for authentication.
• secret_key::String: Secret key for authentication.
• interface::String: Interface for the client.
• proxy::String: Proxy information for the client.
• account_name::String: Account name associated with the client.
• description::String: Description of the client.

BithumbAPIError{T} <: AbstractAPIsError

Exception thrown when an API method fails with code T.

Required fields

• status::Int64: Error status code.

Optional fields

• message::String: Error message.

Data{D<:Union{A,Vector{A},Dict{String,A}} where {A<:AbstractAPIsData}} <: AbstractAPIsData

Required fields

• status::String: Request status.
• data::D: Request result data.

Optional fields

• date::NanoDate: Current time.

public_client = BithumbClient(; base_url = "https://api.bithumb.com")

asset_status(client::BithumbClient, query::AssetStatusQuery)
asset_status(client::BithumbClient = Bithumb.Spot.public_client; kw...)

Provides information on the deposit/withdrawal status of virtual assets.

GET /public/assetsstatus/multichain/{currency}

Parameters:

Code samples:

using Serde
using CryptoExchangeAPIs.Bithumb

result = Bithumb.Spot.asset_status(; 
    currency = "ADA",
)

to_pretty_json(result.result)

Result:

{
  "status":"0000",
  "date":null,
  "data":[
    {
      "currency":"ADA",
      "net_type":"ADA",
      "deposit_status":true,
      "withdrawal_status":true
    }
  ]
}

candle(client::BithumbClient, query::CandleQuery)
candle(client::BithumbClient = Bithumb.Spot.public_client; kw...)

Provides virtual asset price and trading volume information by time and section.

GET public/candlestick/{order_currency}_{payment_currency}/{chart_intervals}

Parameters:

Code samples:

using Serde
using CryptoExchangeAPIs.Bithumb

result = Bithumb.Spot.candle(;
    order_currency = "BTC",
    payment_currency = "KRW",
    interval = Bithumb.Spot.Candle.h24,
)

to_pretty_json(result.result)

Result:

{
  "status":"0000",
  "date":null,
  "data":[
    {
      "timestamp":"2024-05-14T15:00:00",
      "open":8.6639e7,
      "close":8.6419e7,
      "high":8.6845e7,
      "low":8.575e7,
      "vol":216.48937355
    },
    ...
  ]
}

market(client::BithumbClient, query::MarketQuery)
market(client::BithumbClient = Bithumb.Spot.public_client; kw...)

List of markets available for trading on Bithumb.

GET v1/market/all

Parameters:

Code samples:

using Serde
using CryptoExchangeAPIs.Bithumb

result = Bithumb.Spot.market()

to_pretty_json(result.result)

Result:

[
  {
    "market":"KRW-BTC",
    "korean_name":"비트코인",
    "english_name":"Bitcoin"
  },
  {
    "market":"KRW-ETH",
    "korean_name":"이더리움",
    "english_name":"Ethereum"
  },
  ...
]

order_book(client::BithumbClient, query::OrderBookQuery)
order_book(client::BithumbClient = Bithumb.Spot.public_client; kw...)

Provides exchange quote information.

GET /public/orderbook/{order_currency}_{payment_currency}

Parameters:

Code samples:

using Serde
using CryptoExchangeAPIs.Bithumb

result = Bithumb.Spot.order_book(;
    order_currency = "BTC",
    payment_currency = "KRW",
    count = 5,
)

to_pretty_json(result.result)

Result:

{
  "status":"0000",
  "date":null,
  "data":{
    "asks":[
      {
        "price":8.6553e7,
        "quantity":0.0011
      },
      ...
    ],
    "bids":[
      {
        "price":8.6502e7,
        "quantity":0.0393
      },
      ...
    ],
    "order_currency":"BTC",
    "payment_currency":"KRW",
    "timestamp":"2024-05-14T22:40:07.140999936"
  }
}

ticker(client::BithumbClient, query::TickerQuery)
ticker(client::BithumbClient = Bithumb.Spot.public_client; kw...)

Provides snapshot information of symbols at the time of request.

GET /v1/ticker

Parameters:

Code samples:

using Serde
using CryptoExchangeAPIs.Bithumb

result = Bithumb.Spot.ticker(;
    markets = "KRW-BTC,KRW-ETH",
)

to_pretty_json(result.result)

Result:

[
  {
    "market": "KRW-BTC",
    "trade_date": "20250630",
    "trade_time": "123643",
    "trade_date_kst": "20250630",
    "trade_time_kst": "213643",
    "trade_timestamp": 1751319403641,
    "opening_price": 147950000,
    "high_price": 148500000,
    "low_price": 146580000,
    "trade_price": 147054000,
    "prev_closing_price": 147950000,
    "change": "FALL",
    "change_price": 896000,
    "change_rate": 0.0061,
    "signed_change_price": -896000,
    "signed_change_rate": -0.0061,
    "trade_volume": 0.000068,
    "acc_trade_price": 41616026654.1438,
    "acc_trade_price_24h": 46041602331.625,
    "acc_trade_volume": 282.15301032,
    "acc_trade_volume_24h": 312.0425921,
    "highest_52_week_price": 163460000,
    "highest_52_week_date": "2025-01-21",
    "lowest_52_week_price": 71573000,
    "lowest_52_week_date": "2024-08-06",
    "timestamp": 1751287007250
  }
]

user_transactions(client::BithumbClient, query::UserTransactionsQuery)
user_transactions(client::BithumbClient; kw...)

Provides information on member transaction completion details.

POST /info/user_transactions

Parameters:

Code samples:

using Serde
using CryptoExchangeAPIs.Bithumb

bithumb_client = Bithumb.Client(;
    base_url = "https://api.bithumb.com",
    public_key = ENV["BITHUMB_PUBLIC_KEY"],
    secret_key = ENV["BITHUMB_SECRET_KEY"],
)

result = Bithumb.Spot.user_transactions(
    bithumb_client;
    order_currency = "BTC",
    payment_currency = "KRW",
)

to_pretty_json(result.result)

Result:

{
  "status": "0000",
  "date":null,
  "data": [
    {
      "search":1,
      "transfer_date":"2019-10-28T11:44:57.148",
      "order_currency":"BTC",
      "payment_currency":"KRW",
      "units":0.0001,
      "price":10000000.0,
      "amount":1000.0,
      "fee_currency":"KRW",
      "fee":2.5,
      "order_balance":6.498881591872,
      "payment_balance":1140499718.0
    },
    ...
  ]
}