# Export T-Bill Investment Trades

## List historical trades

### Business Goal

Provide customers and internal systems with a record of all individual T-bill buy, sell and maturity activity, to monitor investment activity and seamlessly integrate this T-bill activity into treasury management systems, accounting systems, and downstream reporting pipelines.

With the following data available for each trade: buy/sell direction, trade date/time, settlement status, settlement date, cusip, quantity, price, trade amount, maturity date, yield to maturity, Jiko pocket

### Business Workflow Example

Customer systems:

1. Determine the range of dates and pockets for which the trade activity is needed.
2. Send to Jiko the inquiry request with the corresponding filters.
3. Translate the received Jiko trade information in the format used by internal systems.
4. Integrate the trade activity in internal systems.
5. Power portfolio and activity views in the user interface of internal systems.


### Relevant API Endpoints

| Step | Purpose | Jiko API Endpoints |
|  --- | --- | --- |
| 1 | List all buy, sell, and maturity events, filtered by pocket and a trade datetime range. | GET [`/api/v1/trades/`](/products/customer-api/reference/trades/list_trades_api_v1_trades__get) |


## Downloads the confirmation for a specific trade

Section in progress.

## Get Current Trading Prices

### Business Goal

Provide an up-to-date value of current T-bill yields across available maturities (4, 13, 26, 52 weeks), with both the discount yield and the equivalent annualized yield to maturity (YTM: before fees and using an annual compound rate of return with the actual day count).

This endpoint supports investment decision-making and portfolio analysis by allowing the evaluation of relative value across maturities using standardized yield metrics.

### Business Workflow Example

Customer systems:

1. When evaluating investment decisions or on a scheduled basis, call Jiko to get current yields.
2. Inform allocation logic in internal systems.
3. Display yields to end-users in other customer systems.
4. Power dashboards, and feed pricing or analytics models.


### Relevant API Endpoints

| Step | Purpose | Jiko API Endpoints |
|  --- | --- | --- |
| 1 | Get the current market price for each T-bill maturity. | GET [`/api/v2/trading-strategies/`](/products/customer-api/reference/trading-strategies-v2) |


### Illustration

Extract from the 4-week maturity:


```json
"items": [
  {
      "id": "UST-4W",
      "description": "US T-bills, 4-week, Buy-and-hold",
      "yield_to_maturity": "0.0366",
      "discount_yield": "0.0354",
      "applicable_to": [
          "REINVESTMENT",
          "DEPOSIT"
      ]
  }
]
```

## Get Earnings

Section in progress.

GET [`/api/v2/pockets/{pocket_id}/earnings/`](/products/customer-api/reference/pockets-v2/get_single_pocket_earnings_api_v2_pockets__pocket_id__earnings__get)