Get a firm quote
Get a firm ScripX quote for a duty credit scrip trade: price one credit by scrip number or a face amount to sell, or a duty requirement to buy, returning price in bps and one all-in paise amount.
quote scope.
This is the call every integration lives on, whether it prices one scrip or a book of them: list a firm’s credits, then take one direct quote per scrip_no, one all-in number, with no aggregation or price modelling on your side.
Sell: price one credit directly
{"side": "sell", "scheme": "RODTEP", "face_paise": 100000000}.
all_in_paise is the one number that changes hands, everything included. valid_until is the firm window; quote_ref is your support reference.
Buy: cover a duty requirement
residual_paise is any duty left to pay in cash.
{"no_quote": true, "reason": "…"} with one of two stable reasons. Treat it as a normal outcome, show the client a retry, and never interpolate a price of your own.Errors
401/403/429, the standard auth errors.422 unprocessable, missing or non-positive amounts.
Next steps
- Place the order
- List a firm’s credits, the sell loop’s input.
Authorizations
Your API key, e.g. scripx_live_…. Bound to one firm; tenant isolation is enforced.
Body
sell: pass scrip_no, OR scheme+face_paise. buy: pass scheme+requirement_paise.
sell, buy required unless scrip_no is given
RODTEP, ROSCTL sell: face value to price (with scheme)
buy: duty amount to cover (with scheme)
sell only: price ONE specific credit directly
Response
OK
Your side only. no_quote:true (with a stable reason) when no firm price is available.
sell, buy sell by scrip_no only: echoes the credit priced
sell: the face priced
buy: the duty amount covered
your price in bps of face
the one number that changes hands, everything included
buy: saved vs paying duty in cash
buy: the whole credits that cover the requirement
buy: duty covered by the bundle
buy: duty left to pay in cash
sell: the quote's firm window (ISO-IST)
stable reference for support