Generates a secure binary payload for the nano in order to authorize the transaction.

  • We send on sell endpoint the quoteId (id generated with the previous call to /quote ). The partner should retrieve the quote data (amounts…) from this id.
  • The final source of Truth for the user is the binary payload you generate.
post/sell

Request

  • Base URL: https://developers.ledger.com (the document declares no server; this is the origin it was published from)
  • URL: https://developers.ledger.com/sell
  • Auth: none declared

Request body

quoteIdstring required

Previously generated quote ID.

amountstring required

Amount requested by the user to be sold.

refundAddressstring required

User's refund address, typically the fromAddress.

fromCryptoCurrencystring required

From currency ID, using the provider's identifiers.

toFiatCurrencystring required

Fiat currency at the ISO-4217 standard.

payloadCryptoCurrencystring required

The ticker of the currency the user wants to sell, as defined in Ledger’s referential (corresponding to currency_from in the protobuf payload). BTC or ETH for example. This ticker will be displayed on the Ledger device.

noncestring required

Value for the device_transaction_id_ng field in the protobuf payload, in hex format of the byte array nonce received by the user.

slippagestring

Value between 0 to 1 (0.1 => 10%). Maximum difference between the quoted amount and the final amount received, as a ratio. If exceeded, user consent is required or a refund is made.

Response

Sell ID with flattened JWS. https://www.rfc-editor.org/rfc/rfc7515#section-7.2.2

sellIdstring required

provider's id of the ongoing sell transaction. This will be used by Ledger's backend to retrieve the status of user sell transaction. A unique id must be generated each time this endpoint is called, even if called with a same quoteId : quoteId != sellId. This is a sell attempt id and several retries sharing the same quote id might be performed by a user.

payinAddressstring required

Provider's payin address.

createdAtstring required

Creation date of the sell payload in ISO-8601 format.

providerFeesstring required

Fees paid to the provider, converted to currencyTo.

referralFeesstring required

Fees paid to Ledger, as a referral fee, converted to currencyTo.

Changes

No recorded changes to this operation across all 1 revision of this API.