KR EOD Files
After each KRX trading day closes, Atomic Vaults produces three end-of-day (EOD) files for each Korean account: Balances, Positions and Transactions. They use the same column layout as the US EOD files, so one parser can read both markets. This page covers delivery and the values specific to Korea.
Delivery
| Channel | |
| Frequency | One email per account for each KRX trading day |
| Timing | The evening of the trading day (KST), after the day is closed |
| Subject | Settlement Files - <account_number> <YYYYMMDD> |
| Attachment | <account_number>_<YYYYMMDD>_files.zip |
| Contents | balances_YYYYMMDD.csv, positions_YYYYMMDD.csv, transactions_YYYYMMDD.csv |
| Recipients | Set up during onboarding. Contact Atomic Vaults to change them. |
Files for a closed day never change. A correction to an earlier day arrives in a later day's Transactions file as a reversal (status C) of the original row, followed by the corrected row if there is one.
SFTP delivery and per-end-customer files are not available for Korea yet.
The transaction rows are also available through GET /kr/transactions once the day is closed.
Conventions
- Currency. Amounts are in KRW.
- Settlement. Trades settle T+2 on KRX trading days.
- Dates.
system_dt,trade_dt,settle_dtandavail_dtareYYYY-MM-DD.entry_dtandexec_dtare UTC timestamps in RFC 3339 format. - Signs. Amounts follow the US file convention: positive when cash leaves the account (a buy, a withdrawal, a fee) and negative when cash comes in (a sell, a deposit, a dividend). Cash balances are negative when the account holds cash. Quantities are positive for shares received and negative for shares delivered.
- Unused columns. Every column in the layout is present. Numeric columns that Korea doesn't use are
0; text columns that Korea doesn't use are empty.
Balances
One row per account. The file has the US Balances columns except the intraday margin columns (iml_*, imd_*), which Korea doesn't use. These columns carry values:
| Field | Value |
|---|---|
requestID | Unique ID for the row |
system_dt | Trading date |
corr | GIGA |
office | KR |
acct_no | Your account number |
acct_type | C (cash) |
currency | KRW |
day_trader | N |
tcash_bal | Trade-date cash balance (negative when the account holds cash) |
scash_bal | Settled cash balance (negative when the account holds cash) |
acash_bal | Same as tcash_bal |
lmv | Market value of trade-date positions at the closing price |
sd_lmv | Market value of settled positions at the closing price |
equity | Trade-date cash plus lmv |
cash_avail | Cash available to withdraw: the lowest of settled, next-day and trade-date cash, and never below 0 |
cash_withdrawable | Same as cash_avail |
unsettled_buys | Amount of buy trades not yet settled |
unsettled_sells | Amount of sell trades not yet settled |
Positions
One row per symbol held. Same columns as the US Positions file:
| Field | Value |
|---|---|
requestID | Unique ID for the row |
system_dt | Trading date |
corr | GIGA |
office | KR |
acct_no | Your account number |
sub_acct_no | LEQT for long positions, SEQT for short positions |
acct_type | C |
symbol | 6-digit Korean issue code, for example 005930 |
sym_no | Empty |
hold_type | L (long) or S (short) |
price | Closing price |
tclose | Trade-date quantity |
tmktval | Trade-date market value |
sclose | Settled quantity |
smktval | Settled market value |
Transactions
One row per fill and one row per cash or corporate-action entry. Same columns as the US Transactions file.
Fills
| Field | Value |
|---|---|
tr_no | Transaction number: the trading date as YYMMDD followed by a 7-digit sequence, for example 2611060000001 |
src_cd | COS |
entry_type | TRD |
trd_type | B (buy) or S (sell) |
cust_type | C |
sub_acct_no | LEQT |
entry_dt, exec_dt | Fill time (UTC) |
trade_dt | Trading date |
settle_dt, avail_dt | Settlement date (T+2) |
symbol | 6-digit Korean issue code |
qty | Fill quantity: positive for a buy, negative for a sell |
price | Fill price |
g_amt | Gross amount, qty × price |
comm | Commission on the fill |
oth_fee | Securities transaction tax on the fill (charged on sells) |
n_amt | Net amount, g_amt + comm + oth_fee |
currency | KRW |
sol_unsol | N |
settled, availed | Y once the trade has settled, otherwise N |
posted | Y |
status | R |
cl_order_id | Your order_id |
order_id | Atomic Vaults av_order_id |
exec_id, fill_id | Fill ID |
Commission is charged at your agreed rate on the day's gross amount per symbol and side, rounded up to the nearest KRW, and spread across that day's fills. Commission and tax are included in the fill rows rather than listed separately.
Cash and corporate-action entries
| Field | Value |
|---|---|
tr_no | Transaction number, continuing the day's sequence |
entry_type | See Entry Types |
entry_dt | When the entry was recorded (UTC) |
trade_dt, settle_dt, avail_dt | Dates of the entry |
symbol, qty, price | Set for corporate actions on a security; empty or 0 for cash entries |
g_amt, n_amt | Amount of the entry |
status | R (posted) or C (reversal of an earlier entry) |
descr | Description of the entry |
ref_id | Groups the rows of one booking, for example a reversal and its correction |
Entry Types
| Code | Description |
|---|---|
TRD | Trade (fill) |
WIREI | Cash deposit |
WIREO | Cash withdrawal |
DIV | Dividend |
DIVTAX | Tax withheld on a dividend |
INT | Interest |
CIL | Cash in lieu |
SPLIT | Stock split |
RSPLIT | Reverse split |
BONUS | Bonus issue |
REORG | Reorganisation |
SSO | Spin-off |
MA | Merger or acquisition |
LIQ | Liquidation |
SC | Symbol change |
COMM | Commission |
BRKCOMM | Broker commission |
TAX | Tax |
CORR | Correction |
ERR | Error offset |
ADJ | Adjustment |