FxHubPartnersApi

<back to all web services

CreateOrderBook

Requires Authentication
The following routes are available for this service:
POST/order_book/create
CreateOrderBook Parameters:
NameParameterData TypeRequiredDescription
OrderBookbodyOrderBookNo
RetailClientbodyRetailClientNo
OrderBook Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
ClientIdformintNo
ClientNameformstringNo
PartnerIdformintNo
PartnerNameformstringNo
DatePlacedformDateTime?No
TimePlacedformstringNo
ExpiryDateformDateTime?No
ExpiryTimeformstringNo
EditTimeformstringNo
CurrencyTypeformstringNo
TradeLevelformdecimal?No
ClientLevelformdecimal?No
CurrencyAmountformdecimal?No
ZarNominalformdecimal?No
TraderNameformstringNo
OrderCommentsformstringNo
OrderTypeformstringNo
OrderStatusformstringNo
HasExpiryformbool?No
IsCorporateOrderformbool?No
RetailClient Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
PartnerIdformintNo
PartnerIdsformList<int>No
PartnerNameformstringNo
ClientTypeformstringNo
FirstNameformstringNo
MiddleNameformstringNo
LastNameformstringNo
FullNamesformstringNo
FirstLastNameformstringNo
TitleformstringNo
GenderformstringNo
RaceformstringNo
ResidencyStatusformstringNo
TaxRefNumberformstringNo
IdNumberformstringNo
DateOfBirthformDateTime?No
PlaceOfBirthformstringNo
NationalityformstringNo
CountryOfResidenceformstringNo
PassportNumberformstringNo
PassportIssueDateformDateTime?No
PassportExpiryDateformDateTime?No
PassportCountryformstringNo
TempResNumberformstringNo
TempResDateformstringNo
EmailAddressformstringNo
ContactNumber1formstringNo
ContactNumber2formstringNo
ContactNumber3formstringNo
AddressformstringNo
SuburbformstringNo
CityformstringNo
ProvinceformstringNo
PostalCodeformstringNo
CountryformstringNo
PostalSameAsStreetformbool?No
PostalAddressformstringNo
PostalSuburbformstringNo
PostalCityformstringNo
PostalProvinceformstringNo
PostalPostalCodeformstringNo
PostalCountryformstringNo
IsSoleProprietorformbool?No
TradingSameAsStreetformbool?No
TradingAddressformstringNo
TradingSuburbformstringNo
TradingCityformstringNo
TradingProvinceformstringNo
TradingPostalCodeformstringNo
TradingCountryformstringNo
OccupationformstringNo
OccupationSpecifyformstringNo
DesignationformstringNo
DesignationSpecifyformstringNo
BusinessTypeformstringNo
IsZarAccountformbool?No
FcaRequiredformbool?No
FcaCurrency1formstringNo
FcaCurrency2formstringNo
FcaDetailsformstringNo
TradeLimitformstringNo
LessR10kformbool?No
LessR20kformbool?No
LessR50kformbool?No
LessR100kformbool?No
MoreR100kformbool?No
MonthlyIncomeformstringNo
AccountPurposeformstringNo
SourceOfFundsformstringNo
SourceOfFundsSpecifyformstringNo
SourceOfWealthformstringNo
SourceOfWealthSpecifyformstringNo
AccountDomicileformstringNo
ThirdPartyAccountformstringNo
InvestmentValueformstringNo
UsPersonYesformbool?No
UsPersonNoformbool?No
TinNumberformstringNo
ExSaTaxResidentYesformbool?No
ExSaTaxResidentNoformbool?No
Country1formstringNo
TinNumber1formstringNo
Country2formstringNo
TinNumber2formstringNo
CurrentDateformDateTime?No
MultipleSignatoriesformboolNo
Capacity1formstringNo
ClSignFullNames2formstringNo
Capacity2formstringNo
MustSignformstringNo
SignedAtformstringNo
StatusformstringNo
CifNumberformstringNo
ZarAccountNumberformstringNo
FcaAccountNumber1formstringNo
FcaAccountNumber2formstringNo
FaceToFaceformbool?No
NonFaceToFaceformbool?No
BrokerIntroducedformbool?No
TradingAccountformbool?No
Residentformbool?No
NonResidentformbool?No
EmigrantBlockedAccountformbool?No
EbaSavingsformbool?No
EbaCurrentformbool?No
EbaTradingAccountformbool?No
ExternalReferenceformstringNo
GeoCodeformstringNo
ExchangeControl1formbool?No
ExchangeControl2formbool?No
ExchangeControl3formbool?No
TheAgentformstringNo
IpIntroducerformstringNo
IsSwitchClientformbool?No
PreviousIntermediaryformstringNo
ResignationDateformDateTime?No
IsPartnerClientformbool?No
ClientAllocatedToPartnerformbool?No
HavePopiPermissionformbool?No
IsSanctionsCheckCompleteformbool?No
SanctionsScreenformstringNo
HasForm25Dataformbool?No
HasClientTccformbool?No
HasClientTccPendingformbool?No
HasHadClientTccformbool?No
IsDeactivatedformbool?No
DeactivatedDateformDateTime?No
DiscretionaryAllowanceformdecimal?No
DaStartDateformDateTime?No
DaEndDateformDateTime?No
ProgressOneformbool?No
ProgressTwoformbool?No
ProgressThreeformbool?No
IsEditingformbool?No
HasFicaUploadformbool?No
CreatedByUserIdformintNo
CompletedNotificationSentformbool?No
HigherRiskClientsChecksDoneformbool?No
LessAnnual100kformbool?No
LessAnnual250kformbool?No
LessAnnual500kformbool?No
LessAnnual1milformbool?No
MoreAnnual1milformbool?No
SpotForeignExchangeformbool?No
ForwardExchangeformbool?No
CreateOrderBookResponse Parameters:
NameParameterData TypeRequiredDescription
ResultformboolNo
MessageformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /order_book/create HTTP/1.1 
Host: api.fxhub.co.za 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	orderBook: 
	{
		id: 0,
		clientId: 0,
		clientName: String,
		partnerId: 0,
		partnerName: String,
		datePlaced: 0001-01-01,
		timePlaced: String,
		expiryDate: 0001-01-01,
		expiryTime: String,
		editTime: String,
		currencyType: String,
		tradeLevel: 0,
		clientLevel: 0,
		currencyAmount: 0,
		zarNominal: 0,
		traderName: String,
		orderComments: String,
		orderType: String,
		orderStatus: String,
		hasExpiry: False,
		isCorporateOrder: False
	},
	retailClient: 
	{
		id: 0,
		partnerId: 0,
		partnerIds: 
		[
			0
		],
		partnerName: String,
		clientType: String,
		firstName: String,
		middleName: String,
		lastName: String,
		fullNames: String String String,
		firstLastName: String String,
		title: String,
		gender: String,
		race: String,
		residencyStatus: String,
		taxRefNumber: String,
		idNumber: String,
		dateOfBirth: 0001-01-01,
		placeOfBirth: String,
		nationality: String,
		countryOfResidence: String,
		passportNumber: String,
		passportIssueDate: 0001-01-01,
		passportExpiryDate: 0001-01-01,
		passportCountry: String,
		tempResNumber: String,
		tempResDate: String,
		emailAddress: String,
		contactNumber1: String,
		contactNumber2: String,
		contactNumber3: String,
		address: String,
		suburb: String,
		city: String,
		province: String,
		postalCode: String,
		country: String,
		postalSameAsStreet: False,
		postalAddress: String,
		postalSuburb: String,
		postalCity: String,
		postalProvince: String,
		postalPostalCode: String,
		postalCountry: String,
		isSoleProprietor: False,
		tradingSameAsStreet: False,
		tradingAddress: String,
		tradingSuburb: String,
		tradingCity: String,
		tradingProvince: String,
		tradingPostalCode: String,
		tradingCountry: String,
		occupation: String,
		occupationSpecify: String,
		designation: String,
		designationSpecify: String,
		businessType: String,
		isZarAccount: False,
		fcaRequired: False,
		fcaCurrency1: String,
		fcaCurrency2: String,
		fcaDetails: String,
		tradeLimit: String,
		lessR10k: False,
		lessR20k: False,
		lessR50k: False,
		lessR100k: False,
		moreR100k: False,
		monthlyIncome: String,
		accountPurpose: String,
		sourceOfFunds: String,
		sourceOfFundsSpecify: String,
		sourceOfWealth: String,
		sourceOfWealthSpecify: String,
		accountDomicile: String,
		thirdPartyAccount: String,
		investmentValue: String,
		usPersonYes: False,
		usPersonNo: False,
		tinNumber: String,
		exSaTaxResidentYes: False,
		exSaTaxResidentNo: False,
		country1: String,
		tinNumber1: String,
		country2: String,
		tinNumber2: String,
		currentDate: 0001-01-01,
		multipleSignatories: False,
		capacity1: String,
		clSignFullNames2: String,
		capacity2: String,
		mustSign: String,
		signedAt: String,
		status: String,
		cifNumber: String,
		zarAccountNumber: String,
		fcaAccountNumber1: String,
		fcaAccountNumber2: String,
		faceToFace: False,
		nonFaceToFace: False,
		brokerIntroduced: False,
		tradingAccount: False,
		resident: False,
		nonResident: False,
		emigrantBlockedAccount: False,
		ebaSavings: False,
		ebaCurrent: False,
		ebaTradingAccount: False,
		externalReference: String,
		geoCode: String,
		exchangeControl1: False,
		exchangeControl2: False,
		exchangeControl3: False,
		theAgent: String,
		ipIntroducer: String,
		isSwitchClient: False,
		previousIntermediary: String,
		resignationDate: 0001-01-01,
		isPartnerClient: False,
		clientAllocatedToPartner: False,
		havePopiPermission: False,
		isSanctionsCheckComplete: False,
		sanctionsScreen: String,
		hasForm25Data: False,
		hasClientTcc: False,
		hasClientTccPending: False,
		hasHadClientTcc: False,
		isDeactivated: False,
		deactivatedDate: 0001-01-01,
		discretionaryAllowance: 0,
		daStartDate: 0001-01-01,
		daEndDate: 0001-01-01,
		progressOne: False,
		progressTwo: False,
		progressThree: False,
		isEditing: False,
		hasFicaUpload: False,
		createdByUserId: 0,
		completedNotificationSent: False,
		higherRiskClientsChecksDone: False,
		lessAnnual100k: False,
		lessAnnual250k: False,
		lessAnnual500k: False,
		lessAnnual1mil: False,
		moreAnnual1mil: False,
		spotForeignExchange: False,
		forwardExchange: False
	}
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	result: False,
	message: String
}