book_offers
Last updated
Last updated
book_offers 메소드는 오더북이라고도 하는 두 통화 간의 오퍼 목록을 검색합니다. 이 응답은 펀딩되지 않은 오퍼는 생략하고 남은 각 오퍼의 총액 중 현재 펀딩된 금액을 보고합니다.
요청 형식의 예시입니다:
요청에는 다음 매개변수가 포함됩니다:
성공적인 응답의 예입니다:
응답은 표준 형식을 따르며, 성공적인 결과에는 다음 필드가 포함됩니다:
표준 오퍼 필드 외에도 오퍼 배열의 멤버에 다음 필드가 포함될 수 있습니다:
일반적인 오류 유형입니다.
invalidParams - 하나 이상의 필드가 잘못 지정되었거나 하나 이상의 필수 필드가 누락되었습니다.
lgrNotFound - ledger_hash 또는 ledger_index에 지정된 ledger이 존재하지 않거나, 존재하지만 서버에 없습니다.
srcCurMalformed - 요청의 taker_pays 필드의 형식이 올바르지 않습니다.
dstAmtMalformed - 요청의 taker_gets 필드의 형식이 올바르지 않습니다.
srcIsrMalformed - 요청의 taker_pays 필드의 발급자 필드가 유효하지 않습니다.
dstIsrMalformed - 요청의 taker_gets 필드의 발행자 필드가 유효하지 않습니다.
badMarket - 원하는 오더북이 존재하지 않습니다(예: 자체적으로 통화를 교환하는 오퍼).
Field
유형
필수 여부
설명
taker_gets
객체
예
제안을 받는 계정이 금액이 없는 통화로 받게 될 자산입니다.
taker_pays
객체
예
제안을 받는 계정이 금액 없이 통화로 지불할 자산입니다.
ledger_hash
아니요
사용할 원장 버전에 대한 20바이트 16진수 문자열입니다. (원장 지정 참조)
ledger_index
아니요
사용할 원장의 원장 인덱스 또는 자동으로 원장을 선택하는 단축 문자열입니다. (원장 지정 참조)
limit
숫자
아니요
반환할 최대 제안 수입니다. 응답에는 더 적은 수의 결과가 포함될 수 있습니다.
taker
문자열
아니요
관점으로 사용할 계정의 주소 입니다. 자금이 조달되지 않은 경우에도 응답에는 이 계정의 제안이 포함됩니다. (이를 사용하여 오더북에서 귀하의 제안보다 높거나 낮은 제안이 무엇인지 확인할 수 있습니다.)
Field
유형
설명
ledger_current_index
(ledger_current_index가 제공된 경우 생략) 이 정보를 검색하는 데 사용된 현재 진행 중인 원장 버전의 원장 인덱스입니다.
ledger_index
요청에 따라 이 데이터를 검색할 때 사용된 원장 버전의 원장 인덱스(ledger_current_index가 제공된 경우 생략).
ledger_hash
(생략 가능) 요청에 따라 이 데이터를 검색할 때 사용된 원장 버전의 식별 해시입니다.
offers
정렬
오퍼 객체의 배열로, 각 오퍼 객체의 필드가 있습니다.
Field
유형
설명
owner_funds
문자열
TakerGets
제안을 하는 쪽이 거래할 수 있는 통화 금액입니다. (XRP는 드롭으로 표시되며 다른 모든 통화는 소수 값으로 표시됩니다.) 거래자가 동일한 책에 여러 제안을 가지고 있는 경우 가장 높은 순위의 제안에만 이 필드가 포함됩니다.
taker_gets_funded
(부분 자금 조달 제안에만 포함됨) 제안의 자금 조달 상태를 고려하여 테이커가 받을 수 있는 최대 통화 금액입니다.
taker_pays_funded
(부분적으로 자금을 조달한 제안에만 포함됨) 제안의 자금 상태를 고려하여 테이커가 지불할 최대 통화 금액입니다.
quality
문자열
환율은 taker_pays
를 taker_gets
으로 나눈 비율입니다. 공평성을 위해 동일한 품질의 오퍼는 자동으로 선입선출 방식으로 처리됩니다. (즉, 여러 사람이 같은 환율로 환전하겠다고 오퍼를 제출하면 가장 오래된 오퍼가 먼저 채택됩니다.)