Skip to main content
POST
Get a firm two-sided quote
A firm price for an exact amount, on either side. Requires the 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

Or price a face amount without naming a credit: {"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

Buy-side quotes require the buy side to be active on your key. Write to amin@eximfiles.io to have it enabled.
Credits transfer whole, so a buy is covered by a bundle of whole credits; residual_paise is any duty left to pay in cash.
When no firm price is available the response is {"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.
Terms used here: scrip_no, scheme, face value, paise, bps, firm quote, all-in price, requirement, residual. Full list in the terminology annexure.

Next steps

Authorizations

X-ScripX-Key
string
header
required

Your API key, e.g. scripx_live_…. Bound to one firm; tenant isolation is enforced.

Body

application/json

sell: pass scrip_no, OR scheme+face_paise. buy: pass scheme+requirement_paise.

side
enum<string>
required
Available options:
sell,
buy
scheme
enum<string>

required unless scrip_no is given

Available options:
RODTEP,
ROSCTL
face_paise
integer

sell: face value to price (with scheme)

requirement_paise
integer

buy: duty amount to cover (with scheme)

scrip_no
string

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.

side
enum<string>
Available options:
sell,
buy
scheme
string
scrip_no
string

sell by scrip_no only: echoes the credit priced

face_paise
integer

sell: the face priced

requirement_paise
integer

buy: the duty amount covered

price_bps
integer

your price in bps of face

all_in_paise
integer

the one number that changes hands, everything included

savings_paise
integer

buy: saved vs paying duty in cash

scrip_nos
string[]

buy: the whole credits that cover the requirement

covered_paise
integer

buy: duty covered by the bundle

residual_paise
integer

buy: duty left to pay in cash

fully_covered
boolean
valid_until
string

sell: the quote's firm window (ISO-IST)

quote_ref
string

stable reference for support

no_quote
boolean
reason
string