nft_sell_offers

nft_sell_offers 메소드는 주어진 NFToken 객체에 대한 판매 오퍼 목록을 반환합니다.

(NonFungibleTokenV1_1 개정에 의해 추가되었습니다.)

요청 형식

요청 형식의 예시입니다:

Note:

이 메소드에 대한 커맨드라인 구문은 없습니다. 대신 json 메소드를 사용하여 커맨드라인에서 이 메소드에 액세스할 수 있습니다.

WebSocket

{
  "command": "nft_sell_offers",
  "nft_id": "00090000D0B007439B080E9B05BF62403911301A7B1F0CFAA048C0A200000007",
  "ledger_index": "validated"
}

JSON-RPC

{
    "method": "nft_sell_offers",
    "params": [
        {
            "nft_id": "00090000D0B007439B080E9B05BF62403911301A7B1F0CFAA048C0A200000007"
        }
    ]
}

요청에는 다음 매개변수가 포함됩니다:

필드	유형	설명
tokenid	문자열	NFToken 객체의 고유 식별자입니다.
## 응답 형식
성공적인 응답의 예:

WebSocket

{
  "result": {
    "nft_id": "00090000D0B007439B080E9B05BF62403911301A7B1F0CFAA048C0A200000007",
    "offers": [
      {
        "amount": "1000",
        "flags": 1,
        "nft_offer_index": "9E28E366573187F8E5B85CE301F229E061A619EE5A589EF740088F8843BF10A1",
        "owner": "rLpSRZ1E8JHyNDZeHYsQs1R5cwDCB3uuZt"
      }
    ]
  },
  "status": "success",
  "type": "response"
}

JSON-RPC

{
  "result": {
    "nft_id": "00090000D0B007439B080E9B05BF62403911301A7B1F0CFAA048C0A200000007",
    "offers": [
      {
        "amount": "1000",
        "flags": 1,
        "nft_offer_index": "9E28E366573187F8E5B85CE301F229E061A619EE5A589EF740088F8843BF10A1",
        "owner": "rLpSRZ1E8JHyNDZeHYsQs1R5cwDCB3uuZt"
      }
    ],
    "status": "success"
  }
}

응답은 표준 형식을 따르며, 성공적인 결과에는 다음 필드가 포함됩니다:

Field	유형	설명
nft_id	문자열	요청에 지정된 대로 이러한 제안이 제공되는 NFToken입니다.
offers	배열	토큰에 대한 구매 제안 목록입니다. 이들 각각은 판매 제안 형식으로 되어 있습니다 (아래 참조).
limit	숫자	(생략 가능)limit 요청서에 명시된 대로 입니다.
marker	marker	(생략 가능) 응답이 페이지로 매겨졌음을 나타내는 서버 정의 값입니다. 이 통화가 중단된 곳에서 재개하려면 이를 다음 통화에 전달하세요. 이 페이지 이후에 정보 페이지가 없으면 생략됩니다.

오퍼 판매

오퍼 배열의 각 멤버는 해당 NFT를 구매할 수 있는 하나의 NFTokenOffer 객체를 나타내며, 다음과 같은 필드를 갖습니다:

Field	유형	설명
amount	문자열 또는 객체	XRP 드롭의 양을 나타내는 문자열 또는 대체 가능한 토큰의 양을 나타내는 객체로 NFT 판매를 위해 제안된 금액입니다. (통화 금액 지정 참조)
flags	숫자	이 제안에 대한 비트 플래그 세트입니다. 가능한 값은 NFTokenOffer 플래그를 참조하세요.
nft_offer_index	문자열	이 제안의 원장 개체 ID입니다.
owner	문자열	이 제안을 제출한 계정입니다.

발생 가능한 오류

• 모든 범용 오류 유형입니다.

• invalidParams - 하나 이상의 필드가 잘못 지정되었거나 하나 이상의 필수 필드가 누락되었습니다.

• actNotFound - 요청의 계정 필드에 지정된 주소가 장부에 있는 계정과 일치하지 않습니다.

• lgrNotFound - ledger_hash 또는 ledger_index로 지정한 ledger이 존재하지 않거나, 존재하지만 서버에 없습니다.