본문으로 건너뛰기

풀 조회

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

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

API

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

Click to open
Check whitelist status

풀이 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 (입력 토큰 fees)

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

Click to open
Check base quantity against quote (입력 토큰 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 풀

풀의 mid price를 반환한다.

Click to open
Retrieve 주문 IDs

풀에서 order_id의 모든 open 주문에 대한 balance_manager를 반환한다.

Click to open
Retrieve prices and quantities for an 오더북

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

level2 오더북에 대한 가격(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 잔액

이 풀에 보관된 모든 잔액을 가져온다.

Click to open
Retrieve 풀 ID

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

Click to open
Retrieve 주문 information

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

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

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

Click to open
Retrieve locked 잔액

풀에서 BalanceManager의 locked 잔액 (base_quantity, quote_quantity, deep_quantity)를 반환한다.

Click to open
Retrieve 풀 파라미터

풀의 trade 파라미터 (taker_fee, maker_fee, stake_required)를 반환한다.

풀의 currently leading proposal에 대해 다음 epoch의 trade 파라미터 (taker_fee, maker_fee, stake_required)를 반환한다.

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

풀의 book 파라미터 (tick_size, lot_size, min_size)를 반환한다.

DEEP fees에 대한 conversion을 결정하는 풀의 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

주어진 파라미터로 지정가 주문을 배치할 수 있는지 확인한다. 주문을 배치할 수 있으면 true를, 그렇지 않으면 false를 반환한다.

주어진 파라미터로 시장가 주문을 배치할 수 있는지 확인한다. 주문을 배치할 수 있으면 true를, 그렇지 않으면 false를 반환한다.

지정가 주문 파라미터를 검증하고 invalid이면 detailed error information을 반환한다.

시장가 주문 파라미터를 검증하고 invalid이면 detailed error information을 반환한다.

Click to open
Pool status

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

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

Click to open
Account queries

풀에서 BalanceManager에 대한 계정이 존재하는지 확인한다.

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