본문으로 건너뛰기

풀 조회

Pool shared object는 SUI/USDC 시장과 같은 시장을 나타낸다. 해당 Pool은 그 고유한 쌍(SUI/USDC)을 나타내는 유일한 object이며, 그 쌍은 해당 Pool의 유일한 member이다. pools의 구조에 대해 더 알아보려면 설계을 참조한다.

거래를 수행하려면 관련 PoolBalanceManagerTradeProof를 전달한다. Pool과 달리 BalanceManager shared object는 어떤 타입의 토큰도 포함할 수 있으므로, 동일한 BalanceManager가 여러 Pool에 접근하여 다양한 거래 페어링과 상호작용할 수 있다. 더 알아보려면 BalanceManager를 참조한다.

API

DeepBookV3는 어떤 pool이든 query하는 데 사용할 수 있는 엔드포인트 세트를 노출한다.

Click to open
Check whitelist status

pool이 whitelisted인지 확인하기 위한 accessor이다.

Click to open
Check quote quantity against base (DEEP fees)

주어진 base 수량에 대해 quote 수량 out을 결정하는 dry run이다. fee로 DEEP를 사용한다.

Click to open
Check base quantity against quote (DEEP fees)

주어진 quote 수량에 대해 base 수량 out을 결정하는 dry run이다. fee로 DEEP를 사용한다.

Click to open
Check quote quantity against base (input token fees)

주어진 base 수량에 대해 quote 수량 out을 결정하는 dry run이다. fee로 입력 토큰을 사용한다.

Click to open
Check base quantity against quote (input token fees)

주어진 quote 수량에 대해 base 수량 out을 결정하는 dry run이다. fee로 입력 토큰을 사용한다.

Click to open
Check quote quantity against quote or base

주어진 base 수량 또는 quote 수량에 대해 quantity out을 결정하는 dry run이다. base 수량과 quote 수량 중 하나만 0이 아니어야 한다. (base_quantity_out, quote_quantity_out, deep_quantity_required)를 반환한다.

Click to open
Check fee required

수량과 가격이 주어지면 주문이 taker인지 maker인지에 따라 필요한 DEEP (deep_required_taker, deep_required_maker)를 반환한다.

Click to open
Retrieve mid price for a pool

pool의 mid price를 반환한다.

Click to open
Retrieve order IDs

pool에서 balance_manager의 모든 open orders에 대한 order_id를 반환한다.

Click to open
Retrieve prices and quantities for an order book

level2 order book에 대한 가격(price_vec)과 수량(quantity_vec)을 보관하는 vector를 반환한다. price_lowprice_high는 inclusive이며, 범위 내의 모든 주문이 반환된다. is_bid는 bids에는 true이고 asks에는 false이다.

level2 order book에 대한 가격(price_vec)과 수량(quantity_vec)을 보관하는 vector를 반환한다. ticks는 best bid와 best ask에서 시작하여 반환할 최대 ticks 수이다. (bid_price, bid_quantity, ask_price, ask_quantity)는 네 개의 vector로 반환된다. 가격 vector는 bids에는 내림차순으로, asks에는 오름차순으로 정렬된다.

Click to open
Retrieve balances

이 pool에 보관된 모든 balance를 가져온다.

Click to open
Retrieve pool ID

자산 타입이 주어지면 pool의 ID를 가져온다.

Click to open
Retrieve order information

order ID를 사용하여 Order struct를 반환한다.

order IDs의 vector를 사용하여 Order structs의 vector를 반환한다.

pool에서 BalanceManager에 속하는 모든 주문에 대한 Order structs의 vector를 반환한다.

Click to open
Retrieve locked balance

pool에서 BalanceManager의 locked balance (base_quantity, quote_quantity, deep_quantity)를 반환한다.

Click to open
Retrieve pool parameters

pool의 trade parameters (taker_fee, maker_fee, stake_required)를 반환한다.

pool의 currently leading proposal에 대해 다음 epoch의 trade parameters (taker_fee, maker_fee, stake_required)를 반환한다.

현재 epoch에서 proposal을 통과시키는 데 필요한 quorum을 반환한다.

pool의 book parameters (tick_size, lot_size, min_size)를 반환한다.

DEEP fees에 대한 conversion을 결정하는 pool의 OrderDeepPrice struct를 반환한다.

Click to open
Retrieve reverse quantity calculations

주어진 quote 수량 out을 받기 위해 필요한 base 수량을 결정하는 dry run이다.

주어진 base 수량 out을 받기 위해 필요한 quote 수량을 결정하는 dry run이다.

Click to open
Pre-trade validation

주어진 parameters로 limit order를 배치할 수 있는지 확인한다. order를 배치할 수 있으면 true를, 그렇지 않으면 false를 반환한다.

주어진 parameters로 market order를 배치할 수 있는지 확인한다. order를 배치할 수 있으면 true를, 그렇지 않으면 false를 반환한다.

limit order parameters를 검증하고 invalid이면 detailed error information을 반환한다.

market order parameters를 검증하고 invalid이면 detailed error information을 반환한다.

Click to open
Pool status

pool이 stable pool인지 확인한다(stable curve pricing을 사용한다).

pool이 registry에 등록되어 있는지 확인한다.

Click to open
Account queries

pool에서 BalanceManager에 대한 account가 존재하는지 확인한다.

pool에서 BalanceManager에 대한 Account struct를 가져온다.