# EntryTrade

Used to record the the execution of a buy or sell transaction resulting in the transfer of securities and corresponding payment and details related to the trade

## Example Usage

```typescript
import { EntryTrade } from "@apexfintechsolutions/ascend-sdk/models/components";

let value: EntryTrade = {};
```

## Fields

| Field                                                                                                                                                                                                            | Type                                                                                                                                                                                                             | Required                                                                                                                                                                                                         | Description                                                                                                                                                                                                      | Example                                                                                                                                                                                                          |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `additionalInstructions`                                                                                                                                                                                         | *string*[]                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                               | To be populated by the submitter of the trade detail                                                                                                                                                             | [<br/>"As-Of Trade Example",<br/>"to Cancel"<br/>]                                                                                                                                                               |
| `alternateOrderId`                                                                                                                                                                                               | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | Max Length 50 characters. Alternate order id from the street used for FRAC trades                                                                                                                                | 8d7f6375                                                                                                                                                                                                         |
| `bookingApiBookingExecutionId`                                                                                                                                                                                   | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | base64 encoded value assigned by the Booking API to all executions                                                                                                                                               | 01HZ5Z4E00AM2DCPK21PYM07PM                                                                                                                                                                                       |
| `bookingApiTradeAllocationId`                                                                                                                                                                                    | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | base64 encoded value assigned by the Booking API if a trade belongs to an allocation                                                                                                                             | 01HYKYBD00JBQAZ8477RD1M8T7                                                                                                                                                                                       |
| `bookingApiTradeId`                                                                                                                                                                                              | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | base64 encoded value assigned by the Booking API to all trades                                                                                                                                                   | 01HYKYBD00JBQAZ8477RD1M8T7                                                                                                                                                                                       |
| `broker`                                                                                                                                                                                                         | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | Executing broker of the trade                                                                                                                                                                                    | JNST                                                                                                                                                                                                             |
| `brokerCapacity`                                                                                                                                                                                                 | [components.EntryTradeBrokerCapacity](../../models/components/entrytradebrokercapacity.md)                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                               | Used to calculate broadridge blotter code                                                                                                                                                                        | PRINCIPAL                                                                                                                                                                                                        |
| `clientMemo`                                                                                                                                                                                                     | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | client usage area (intact). len 20                                                                                                                                                                               | ["Detail from client", "More details from client"]                                                                                                                                                               |
| `clientOrderId`                                                                                                                                                                                                  | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | Max Length 50 characters. Client provided order id present in exec reports                                                                                                                                       | 0db56450                                                                                                                                                                                                         |
| `exchange`                                                                                                                                                                                                       | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | MIC code for the exchange                                                                                                                                                                                        | OTC                                                                                                                                                                                                              |
| `executionId`                                                                                                                                                                                                    | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | Max Length 50 characters. Execution id from the street                                                                                                                                                           | 01HZ5Z4E003KJ7B7FK3GGX2V74                                                                                                                                                                                       |
| `executionOnly`                                                                                                                                                                                                  | *boolean*                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                               | Indicates whether Apex is the clearing broker for this trade                                                                                                                                                     | false                                                                                                                                                                                                            |
| `externalId`                                                                                                                                                                                                     | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | Max Length 50 characters. External system id provided by a client                                                                                                                                                | 01HAWHW7PSNS99H9SSCY3J3MXZ_FROM_STREET-SELL-393767f7-0db5645                                                                                                                                                     |
| `fundConfirmationNumber`                                                                                                                                                                                         | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | The confirmation number associated with a mutual fund trade                                                                                                                                                      | 010038862                                                                                                                                                                                                        |
| `gatewayClientOrderId`                                                                                                                                                                                           | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | Order id generated by trading-gateway (Trade-Ex) to uniquely identify all orders in their system Used as the client_order_id on new order singles sent downstream of the trading-gateway                         | 7039acda                                                                                                                                                                                                         |
| `internalError`                                                                                                                                                                                                  | *boolean*                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                               | If set to true, indicates the trade should be omitted from client billing                                                                                                                                        | false                                                                                                                                                                                                            |
| `isWriteoff`                                                                                                                                                                                                     | *boolean*                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                               | set on penny-for-the-lot trades                                                                                                                                                                                  | false                                                                                                                                                                                                            |
| `lots`                                                                                                                                                                                                           | [components.Lot](../../models/components/lot.md)[]                                                                                                                                                               | :heavy_minus_sign:                                                                                                                                                                                               | Trade lots                                                                                                                                                                                                       |                                                                                                                                                                                                                  |
| `market`                                                                                                                                                                                                         | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | "MMAP" for multi market average price, "UNKN" for unknown                                                                                                                                                        | MMAP                                                                                                                                                                                                             |
| `orderId`                                                                                                                                                                                                        | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | Max Length 50 characters. Internally generated order id that is returned to client on exec reports                                                                                                               | 8d7f6375                                                                                                                                                                                                         |
| `prevailingMarketPrice`                                                                                                                                                                                          | [components.EntryTradePrevailingMarketPrice](../../models/components/entrytradeprevailingmarketprice.md)                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | The price for the instrument that is prevailing in the market                                                                                                                                                    | {<br/>"value": "0.25"<br/>}                                                                                                                                                                                      |
| `priceAdjustmentRecord`                                                                                                                                                                                          | [components.EntryPriceAdjustmentRecord](../../models/components/entrypriceadjustmentrecord.md)                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                               | Information about any price adjustments applied to the security                                                                                                                                                  |                                                                                                                                                                                                                  |
| `route`                                                                                                                                                                                                          | *string*                                                                                                                                                                                                         | :heavy_minus_sign:                                                                                                                                                                                               | The execution route Apex used for this trade                                                                                                                                                                     | MNGD                                                                                                                                                                                                             |
| `specialInstructions`                                                                                                                                                                                            | *string*[]                                                                                                                                                                                                       | :heavy_minus_sign:                                                                                                                                                                                               | Special instructions for the trade                                                                                                                                                                               | [<br/>"WITH_DIVIDEND",<br/>"OPTION_ASSIGNMENT"<br/>]                                                                                                                                                             |
| `whenIssued`                                                                                                                                                                                                     | *boolean*                                                                                                                                                                                                        | :heavy_minus_sign:                                                                                                                                                                                               | Indicates the trade was executed in a security that is not currently listed. When-issued securities are bought and sold before they are officially issued, allowing investors to speculate on their future value | false                                                                                                                                                                                                            |
| `yieldRecords`                                                                                                                                                                                                   | [components.YieldRecord](../../models/components/yieldrecord.md)[]                                                                                                                                               | :heavy_minus_sign:                                                                                                                                                                                               | The yields associated with a fixed income trade Only valid if the SecurityType is FIXED_INCOME                                                                                                                   |                                                                                                                                                                                                                  |