Qodex.ai

Trade Entry

POST {{URL_ORIGIN}}/api/operations/enter-trade

Trade Entry API allows you to capture trade that was done out of the order book

Trade Entry- Fields

FieldTypeDescription
instrumentIdIntInstrument id for the trade
typeeNumBlock/ EFRP/ Other

of the trade
priceDecimalTrade price
quantityDecimalTrade quantity
buySide objSee below
sellSide objSee below
Side obj-
FieldTypeDescription
mpIdIntmpId
accountTypeeNumClient/House
parties[]objlist of parties obj
parties obj-
FieldTypeDescription
idstring(20)The Id of the party
sourceCharId source = D
roleintId role = 38

Trade Entry- Error Codes

CodeMessage
1System is unavailable
100Missing or invalid parameter: [FieldName]
100Trade [FieldName] must be less than [maxLong/10^ fieldPrecision
100Trade [FieldName] must be above than [minLong/10^ fieldPrecision]
101[FieldName] not found
102Market is closed
102Currently not allowed
102Trading is not allowed during auction call
102Trading is not allowed during crossing
102Instrument trading is not allowed
102Price precision is[PricePrecision]
102Quantity precision is[QuantityPrecision]
102Minimum trade quantity is [MinQuantity]
NEW 102MinQuantity = max( minQuantity,
minQuantityTradeEntry.amount)
102Maximum trade quantity is [MaxQuantity]
102Quantity increment is [quantityIncrement]
102Instrument trading is halted
102Price breaches [FieldName] of [FieldValue]
102Maximum value is [maxOrderValue]
102Price tick size is [tickSize]
102Trading is not allowed
102Missing position account
10001Permission denied

Request Body

{"instrumentId"=>"123", "type"=>"Block", "price"=>"1234", "quantity"=>"10", "buy"=>{"mpId"=>"10", "accountType"=>"Client", "parties"=>[{"id"=>"ABC", "source"=>"D", "role"=>"38"}]}, "sell"=>{"mpId"=>"11", "accountType"=>"House", "parties"=>[{"id"=>"12345", "source"=>"D", "role"=>"38"}]}, "comment"=>"New trade entry"}

RESPONSES

status: OK

{"id":"285","data":{"instrumentId":"239","type":"Block","price":"1234","quantity":"10","buy":{"mpId":"15","accountType":"Client","parties":[{"id":"ABC","source":"D","role":"38"}]},"sell":{"mpId":"15","accountType":"House","parties":[{"id":"12345","source":"D","role":"38"}]}},"requestType":"TradeEntry","name":"INS1","status":"Pending","makerComment":"New trade entry","makerUserId":"auth0|6310aa4ba8cae50015ee3678","timestamp":"2024-02-29T09:37:20.237"}