API Specification Revision History

Files changed (1) hide show
  1. old.yml 2026-05-07 19:22:09 → 21_インターフェース/1_1_API仕様書.yml 2026-05-07 19:19:59 +889 -125
old.yml 2026-05-07 19:22:09 → 21_インターフェース/1_1_API仕様書.yml 2026-05-07 19:19:59 RENAMED
@@ -1,958 +1,1722 @@
1
  openapi: 3.0.0
2
  servers:
3
  - url: https://crednex.jpx.co.jp/api/v1
4
  description: Production server
5
  - url: https://stg.crednex.jpx.co.jp/api/v1
6
  description: Staging server
7
  info:
8
  title: ETF Creation Redemption Platform (CredNex) API Specification
9
- version: 1.1.1
10
  description: |
11
  ## Outline
12
 
13
  #### Production Environment
14
 
15
  URL: https://crednex.jpx.co.jp/api/v1
16
 
17
  Available Time: Weekdays 7:00 a.m-10:00 p.m (JST)
18
 
19
  #### Demo Environment
20
 
21
  URL: https://stg.crednex.jpx.co.jp/api/v1
22
 
23
  Available Time: Weekdays 7:00 a.m-10:00 p.m (JST)
24
 
25
 
26
  #### Network
27
 
28
  - The access route is provided only via the Internet.
29
  - Global IP for each environment of this system is not fixed.
30
 
31
  ## Preparations
32
 
33
 
34
  #### API Key
35
 
36
  Getting an API key is required.
37
  An API key is an unique key for each API user.
38
  It is used for this service to identify API users.
39
  Any API users who wish to use the APIs on this service must request TSE to issue API keys in advance.
40
  The API key should be set in the X-API-KEY in header every time you send an API call.
41
 
42
 
43
  #### IP Address Whitelisting
44
 
45
  You must submit the global IP address of the system making API calls to TSE.
46
  All API keys are linked to global IP addresses, and API calls from IP addresses not submitted in advance will not be accepted.
47
 
48
 
49
  #### Rate Limits
50
 
51
- The maximum frequency of API calls is limited to approximately once every second per API key. This value is subject to change in the future.
52
- When the limit is reached, the user will receive an error response.
53
- Overly frequent access is prohibited as stated in the Terms and Conditions. If such behavior is detected, TSE may issue a warning to the user.
 
54
 
55
- ## Authorization
56
 
57
- |Method|Endpoint|MM|AP (Agency)|AP (Prop)|
58
- |:----|:----|:----|:----|:----|
59
- |GET|ANY|Available|Available|Available|
60
- |POST|/applications|Available|Available|Available|
61
- |PUT|/applications/{applicationId}/approve|N/A|Available|Available|
62
- |PUT|/applications/{applicationId}/deny|N/A|Available|Available|
63
- |PUT|/applications/{applicationId}/approveCancellationRequest|N/A|Available|Available|
64
- |PUT|/applications/{applicationId}/denyCancellationRequest|N/A|Available|Available|
65
- |PUT|/applications/{applicationId}/cancellationRequest|Available|N/A|Available|
66
 
 
67
 
 
 
 
 
 
 
 
 
 
 
 
 
 
68
  paths:
69
  /applications:
70
  get:
71
  summary: Get applicationId of creation and redemption application
72
  description: Get applicationId for which the user has permissions to view
73
  operationId: getApplicationIds
74
  tags:
75
  - applications
76
  parameters:
77
  - name: applicationDate
78
  in: query
79
  schema:
80
  type: string
81
  format: date
82
- description: Application date
83
  - name: statementFixingDate
84
  in: query
85
  schema:
86
  type: string
87
  format: date
88
- description: Statement fixing date
89
  - name: status
90
  in: query
91
  schema:
92
  type: string
93
  description: Specify the status of the creation and redemption applications
 
 
 
 
 
 
 
 
 
 
94
  responses:
95
  '200':
96
  description: Success operation
97
  content:
98
  application/json:
99
  schema:
100
  type: object
101
  properties:
102
  applications:
103
  type: array
104
  items:
105
  type: object
106
  properties:
107
  id:
108
  type: string
109
  example: '2024123100010001'
110
  description: Application ID
111
  status:
112
  type: string
113
  enum:
114
  - "ApplicationInProcessAP"
115
  - "ApplicationInProcessAM"
116
  - "Accepted"
117
  - "StatementInProcessTB"
118
  - "StatementReturnedForRevisionAM"
119
  - "StatementFixed"
120
  - "CancelRequestInProcessAP"
121
  - "CancelRequestInProcessAM"
122
- - "Canceled"
 
 
 
 
123
  hasMore:
124
  type: boolean
125
  example: false
126
  description: Whether there are more than 1,000 application IDs. If true, please send a request again by narrowing down the conditions such as application date, statement fixing date, and status.
127
  post:
128
  summary: Register for your creation/redemption application
129
  description: |
130
  Fill in the information required to apply for creation/redemption and register your application.
131
 
132
  If `isClearing` is not specified, the CredNex system will automatically complete the value of `isClearing` for the application.
133
  The value set depends on `clearingType` of the issue being applied for.
134
  If the `clearingType` in each issue's basic information is Clearing or Selectable, `isClearing` will be set to true and the application will be registered as cleared by JSCC.
135
  If the `clearingType` is Non-Clearing, `isClearing` will be set to false and the application will be registered as non-cleared by JSCC.
136
  operationId: registerApplication
137
  tags:
138
  - applications
139
  requestBody:
140
  required: true
141
  content:
142
  application/json:
143
  schema:
144
  $ref: '#/components/schemas/Application'
145
  responses:
146
  '201':
147
  description: Created
148
  content:
149
  application/json:
150
  schema:
151
  type: object
152
  properties:
153
  applicationId:
154
  type: string
155
  example: '2024123100010001'
156
  '400':
157
  description: "Bad Request"
158
  content:
159
  application/json:
160
  schema:
161
  type: object
162
  properties:
163
  message:
164
  type: string
165
  enum:
166
  - ETF code or AP code is incorrect.
167
  - Application date is incorrect.
168
  - Cut-off time for this ETF fund has already elapsed.
169
  - Number of shares is incorrect.
170
  - The number of digits in 'numberOfShares' is exceeded.
171
- - Number of shares must be an integer multiple of the order unit.
172
  - Number of shares must be exceeded the minimum.
173
  - Number of shares must be an integer multiple of the trading unit. The trading unit is {trading unit}.
174
  - This issue can only be applied with clearing.
175
  - This issue can only be applied with non-clearing.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
176
  example: 'ETF code or AP code is incorrect.'
177
  '403':
178
  description: 'Forbidden'
179
  content:
180
  application/json:
181
  schema:
182
  type: object
183
  properties:
184
  message:
185
  type: string
186
- example: 'You are not allowed to register an application.'
 
 
187
  /applications/{applicationId}:
188
  get:
189
  summary: Get detailed application information
190
  description: 'Specify the applicationId to get details of the applications that the user has permission to view.'
191
  parameters:
192
  - $ref: '#/components/parameters/applicationId'
193
  operationId: getApplicationDetails
194
  tags:
195
  - applications
196
  responses:
197
  '200':
198
  description: Success operation
199
  content:
200
  application/json:
201
  schema:
202
  $ref: '#/components/schemas/ApplicationInfo'
203
  '403':
204
  description: 'Forbidden'
205
  content:
206
  application/json:
207
  schema:
208
  type: object
209
  properties:
210
  message:
211
  type: string
212
- example: 'You are not allowed to access this application.'
213
  /applications/{applicationId}/approve:
214
  put:
215
  summary: Approve a creation/redemption application
216
  parameters:
217
  - $ref: '#/components/parameters/applicationId'
218
- description: 'Approve an application from market makers.'
 
 
 
219
  operationId: approveApplication
220
  tags:
221
  - applications
222
  responses:
223
  '200':
224
  description: Success operation
225
  '400':
226
  description: 'Bad Request'
227
  content:
228
  application/json:
229
  schema:
230
  type: object
231
  properties:
232
  message:
233
  type: string
234
  enum:
235
  - This approval is not available for this application ID.
236
  - This application cannot be approved because it has exceeded the cut-off.
237
- example: 'This approval is not available for this application ID.'
238
  '403':
239
  description: 'Forbidden'
240
  content:
241
  application/json:
242
  schema:
243
  type: object
244
  properties:
245
  message:
246
  type: string
247
- example: 'You are not allowed to access this application.'
 
 
 
248
  /applications/{applicationId}/deny:
249
  put:
250
  summary: Deny a creation/redemption application
251
  parameters:
252
  - $ref: '#/components/parameters/applicationId'
253
- description: 'Deny an application from market makers.'
 
 
 
254
  operationId: denyApplication
255
  tags:
256
  - applications
257
  responses:
258
  '200':
259
  description: Success operation
260
  '400':
261
  description: 'Bad Request'
262
  content:
263
  application/json:
264
  schema:
265
  type: object
266
  properties:
267
  message:
268
  type: string
269
- example: 'This denial is not available for this application ID.'
270
  '403':
271
  description: 'Forbidden'
272
  content:
273
  application/json:
274
  schema:
275
  type: object
276
  properties:
277
  message:
278
  type: string
279
- example: 'You are not allowed to access this application.'
 
 
 
280
  /applications/{applicationId}/approveCancellationRequest:
281
  put:
282
  summary: Approve a cancellation request
283
  parameters:
284
  - $ref: '#/components/parameters/applicationId'
285
- description: 'Approve a cancellation request from market makers.'
 
 
 
286
  operationId: approveCancellationRequest
287
  tags:
288
  - applications
289
  responses:
290
  '200':
291
  description: Success operation
292
  '400':
293
  description: 'Bad Request'
294
  content:
295
  application/json:
296
  schema:
297
  type: object
298
  properties:
299
  message:
300
  type: string
301
- example: 'This approval is not available for this application ID.'
302
  '403':
303
  description: 'Forbidden'
304
  content:
305
  application/json:
306
  schema:
307
  type: object
308
  properties:
309
  message:
310
  type: string
311
- example: 'You are not allowed to access this application.'
 
 
 
312
  /applications/{applicationId}/denyCancellationRequest:
313
  put:
314
  summary: Deny a cancellation request
315
  parameters:
316
  - $ref: '#/components/parameters/applicationId'
317
- description: 'Deny a cancellation request from market makers.'
 
 
 
318
  operationId: denyCancellationRequest
319
  tags:
320
  - applications
321
  responses:
322
  '200':
323
  description: Success operation
324
  '400':
325
  description: 'Bad Request'
326
  content:
327
  application/json:
328
  schema:
329
  type: object
330
  properties:
331
  message:
332
  type: string
333
- example: 'This denial is not available for this application ID.'
334
  '403':
335
  description: 'Forbidden'
336
  content:
337
  application/json:
338
  schema:
339
  type: object
340
  properties:
341
  message:
342
  type: string
343
- example: 'You are not allowed to access this application.'
 
 
 
344
  /applications/{applicationId}/cancellationRequest:
345
  put:
346
  summary: Request APs to cancel an application
347
  parameters:
348
  - $ref: '#/components/parameters/applicationId'
349
  description: 'Request APs to cancel a registered application.'
350
  operationId: cancellationRequest
351
  tags:
352
  - applications
353
  responses:
354
  '200':
355
  description: Success operation
356
  '400':
357
  description: 'Bad Request'
358
  content:
359
  application/json:
360
  schema:
361
  type: object
362
  properties:
363
  message:
364
  type: string
 
 
 
365
  example: 'Cancellation is not available for this application ID.'
366
  '403':
367
  description: 'Forbidden'
368
  content:
369
  application/json:
370
  schema:
371
  type: object
372
  properties:
373
  message:
374
  type: string
375
- example: 'You are not allowed to access this application.'
 
 
 
376
  /statements/{applicationId}:
377
  get:
378
  summary: Get statement data
379
- description: Get statement data for each applicationId.
380
- operationId: getStatementjson
381
  parameters:
382
  - $ref: '#/components/parameters/applicationId'
383
  tags:
384
  - applications
385
  responses:
386
  '200':
387
  description: Success operation
388
  content:
389
  application/json:
390
  schema:
391
  $ref: '#/components/schemas/Statements'
392
  '400':
393
  description: 'Bad Request'
394
  content:
395
  application/json:
396
  schema:
397
  type: object
398
  properties:
399
  message:
400
  type: string
401
- example: 'This request is not available for this application ID.'
402
  '403':
403
  description: 'Forbidden'
404
  content:
405
  application/json:
406
  schema:
407
  type: object
408
  properties:
409
  message:
410
  type: string
411
- example: 'You are not allowed to access this application.'
412
  /issues:
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
413
  get:
414
  summary: Get basic information of each issue
415
  description: Get basic information of each issue.
416
- operationId: getIssueInfojson
417
  tags:
418
- - information
419
- responses:
420
  '200':
421
  description: Success operation
422
  content:
423
  application/json:
424
  schema:
425
  $ref: '#/components/schemas/Issues'
426
  /issues/blackout:
427
  get:
428
  summary: Get blackout dates of each issue
429
  description: Get blackout dates of each issue.
430
- operationId: getBlackoutCalendarjson
431
  tags:
432
  - information
433
  responses:
434
  '200':
435
  description: Success operation
436
  content:
437
  application/json:
438
  schema:
439
  type: object
440
  properties:
441
  issues:
442
  type: array
443
  items:
444
  $ref: '#/components/schemas/Blackout'
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
445
  security:
446
  - ApiKeyAuth: []
447
  components:
448
  securitySchemes:
449
  ApiKeyAuth:
450
  type: apiKey
451
  in: header
452
  name: X-API-KEY
453
  schemas:
454
  Application:
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
455
  type: object
456
  properties:
 
 
 
 
 
 
 
 
 
 
 
 
 
 
457
  applicationDate:
458
  type: string
459
  format: date
460
  description: Application date
461
  example: '2025-04-15'
 
 
 
 
 
 
 
 
462
  apCode:
463
  type: string
464
  description: AP code. 5-digit number.
465
  example: '12345'
466
  etfCode:
467
  type: string
468
- description: ETFfund code. 5-digit alphanumeric character.
469
  example: '12340'
 
 
 
 
 
 
 
470
  creationOrRedemption:
471
  type: string
472
- description: Specify Creation or Redemption. 'C':Creation 'R':Redemption
473
  example: 'C'
474
- numberOfShares:
475
- type: integer
476
- description: Number of shares.
477
- example: 10000
478
- format: int32
479
- pcfNumber:
480
- type: string
481
- description: PCF number. 16-digit alphanumeric character.
482
- example: '1234567890123456'
483
- notes:
484
- type: string
485
- description: Notes from market makers to APs.
486
- example: 'string'
487
  isClearing:
488
  type: boolean
489
  description: |
490
  Cleared by JSCC or non-cleared. false:non-cleared true:cleared.
491
-
492
- If `isClearing` is not specified, the CredNex system will automatically complete the value of `isClearing` for the application.
493
- The value set depends on `clearingType` of the issue being applied for.
494
- If the `clearingType` in each issue's basic information is Clearing or Selectable, `isClearing` will be set to true and the application will be registered as cleared by JSCC.
495
- If the `clearingType` is Non-Clearing, `isClearing` will be set to false and the application will be registered as non-cleared by JSCC.
496
- example: true
497
- required:
498
- - applicationDate
499
- - apCode
500
- - etfCode
501
- - creationOrRedemption
502
- - numberOfShares
503
- ApplicationInfo:
504
- allOf:
505
- - $ref: '#/components/schemas/Application'
506
- properties:
507
- status:
508
  type: string
509
- enum:
510
- - "ApplicationInProcessAP"
511
- - "ApplicationInProcessAM"
512
- - "Accepted"
513
- - "StatementInProcessTB"
514
- - "StatementReturnedForRevisionAM"
515
- - "StatementFixed"
516
- - "CancelRequestInProcessAP"
517
- - "CancelRequestInProcessAM"
518
- - "Canceled"
519
- example: "ApplicationInProcessAP"
520
- description: Application status at the time.
521
- # codesOfTreasuryStock:
522
- # type: array
523
- # items:
524
- # type: string
525
- # example: '12340'
526
- # description: 5-digit code of treasury stock.
527
  jasdecAccountInformation:
528
  type: string
529
  example: '1234567'
530
  description: JASDEC account information. 7-digit number.
531
  navPerShareCalculationDate:
532
  type: string
533
  format: date
534
  example: '2025-05-29'
535
  description: NAV per share calculation date.
536
  statementFixingDate:
537
  type: string
538
  format: date
539
  example: '2025-05-29'
540
  description: Statement fixing date.
541
  trustEstablishmentOrCancellationDate:
542
  type: string
543
  format: date
544
  example: '2025-05-30'
545
  description: Trust establishment or cancellation date.
546
  settlementDate:
547
  type: string
548
  format: date
549
  example: '2025-05-31'
550
  description: Settlement date.
551
  dvpClearingPrice:
552
  type: string
553
- example: '12345678901234.1234'
554
  description: |
555
  DVP clearing price. Used only if an application is in cash ETF and cleared.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
556
  Issues:
557
  type: object
558
  properties:
559
  issues:
560
  type: array
561
  items:
562
  type: object
563
  properties:
564
  etfCode:
565
  type: string
566
  description: ETF fund code. 5-digit alphanumeric character.
567
  example: '12340'
568
  inKindOrInCash:
569
  type: string
570
  description: Specify in-kind or in-cash.
571
  example: 'CashCreationCashRedemption'
572
  enum:
573
  - CashCreationCashRedemption
574
  - InKindCreationInKindRedemption
575
- - CashCreationInKindRedemption
576
  etfNameJa:
577
  type: string
578
  description: ETF fund name in Japanese.
579
  example: 'XXX ファンド'
580
  etfNameEn:
581
  type: string
582
  description: ETF fund name in English.
583
  example: 'XXX fund'
 
 
 
 
584
  cutoffTimeExcludingTreasuryStock:
585
  type: string
586
  description: Cut-off time (JST) for cases where the treasury stock of AP is not included in the basket. All cut-off time for in cash ETF funds are placed in this field.
587
  example: '15:30'
588
  creation:
589
  type: object
590
  properties:
591
  clearingType:
592
  type: string
593
  enum:
594
  - Clearing
595
  - Non-Clearing
596
  - Selectable
597
  description: It means whether this issue can be cleared by JSCC or not. For issues that are selectable, applicants can choose whether or not to cleared by JSCC when registering their application.
598
  example: 'Clearing'
599
  schedule:
600
  type: object
601
  properties:
602
  clearing:
603
  $ref: "#/components/schemas/CreationSchedule"
604
  nonClearing:
605
  $ref: "#/components/schemas/CreationSchedule"
606
  example:
607
  clearing:
608
  navPerShareCalculationDate: 0
609
  statementFixingDate: 1
610
  trustEstablishmentDate: 2
611
  settlementDate: 2
612
  nonClearing: null
613
  orderUnit:
614
  type: integer
615
  description: Order unit in case of creation. If it is 10000, applicants can only request for an integer multiple of 10,000 as number of shares.
616
  example: 10000
617
  minimumNumberOfShares:
618
  type: integer
619
  description: Minimum number of shares in case of creation. If it is 30000, applicants can request in quantities of 30,000 or more.
620
  example: 30000
621
  redemption:
622
  type: object
623
  properties:
624
  clearingType:
625
  type: string
626
  enum:
627
  - Clearing
628
  - Non-Clearing
629
  - Selectable
630
  description: It means whether this issue can be cleared by JSCC or not. For issues that are selectable, applicants can choose whether or not to cleared by JSCC when registering their application.
631
  example: 'Selectable'
632
  schedule:
633
  type: object
634
  properties:
635
  clearing:
636
  $ref: "#/components/schemas/RedemptionSchedule"
637
  nonClearing:
638
  $ref: "#/components/schemas/RedemptionSchedule"
639
  example:
640
  clearing:
641
  navPerShareCalculationDate: 0
642
  statementFixingDate: 1
643
  trustCancellationDate: 2
644
  settlementDate: 2
645
  nonClearing:
646
  navPerShareCalculationDate: 0
647
  statementFixingDate: 1
648
  trustCancellationDate: 2
649
  settlementDate: 2
650
  orderUnit:
651
  type: integer
652
  description: Order unit in case of redemption. If it is 10000, applicants can only request for an integer multiple of 10,000 as number of shares.
653
  example: 10000
654
  minimumNumberOfShares:
655
  type: integer
656
  description: Minimum number of shares in case of redemption. If it is 30000, applicants can request in quantities of 30,000 or more.
657
  example: 30000
 
 
 
 
 
 
658
  earlyRedemptionClause:
659
  type: integer
660
  description: The number of early redemption shares specified in the terms and conditions of an investment trust for each fund. This is an optional field.
661
  example: 100000
662
  issuersOptionalFundCode:
663
  type: string
664
  description: Fund code used by the issuer to identify the fund internally. This is an optional field.
665
- example: 'ABCD1234'
666
  isinCode:
667
  type: string
668
  description: ISIN code. 12-digit alphanumeric character.
669
  example: 'JP1234567890'
670
  amCode:
671
  type: string
672
  description: AM code. 5-digit number.
673
  example: '00123'
674
  amNameJa:
675
  type: string
676
  description: AM name in Japanese.
677
  example: 'XXX アセットマネジメント'
678
  amNameEn:
679
  type: string
680
  description: AM name in English.
681
  example: 'XXX Asset Management'
682
  tbCode:
683
  type: string
684
  description: TB code. 5-digit number.
685
  example: '00001'
686
  tbNameJa:
687
  type: string
688
  description: TB name in Japanese.
689
  example: 'XXX 信託銀行'
690
  tbNameEn:
691
  type: string
692
  description: TB name in English.
693
  example: 'XXX Trust Bank Co., Ltd.'
694
  handlingPeriodFrom:
695
  type: string
696
  description: Start date of available period for handling.
697
  example: '2024-12-03'
698
  handlingPeriodTo:
699
  type: string
700
  description: End date of available period for handling. If it is null, the end date is undecided.
701
  example: '2025-09-21'
702
  DateList:
703
  type: array
704
  items:
705
  type: string
706
  format: date
707
  example: '1992-12-02'
708
  Blackout:
709
  type: object
710
  properties:
711
  etfCode:
712
  type: string
713
  example: '12340'
714
  creationBlackoutDates:
715
  type: array
716
  items:
717
  type: string
718
  format: date
719
  example: '1992-12-02'
720
  redemptionBlackoutDates:
721
  type: array
722
  items:
723
  type: string
724
  format: date
725
  example: '1992-12-02'
726
-
727
  Statements:
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
728
  type: object
729
  properties:
 
 
 
 
730
  applicationId:
731
  type: string
732
  example: '2024123100010001'
733
  description: Application ID
734
  pcfNumber:
735
  type: string
736
  example: '1234567890123456'
737
  description: PCF number. 16-digit alphanumeric character.
738
  amCode:
739
  type: string
740
  example: '00123'
741
  description: AM code. 5-digit number.
742
  amNameJa:
743
  type: string
744
  example: 'XXX アセットマネジメント'
745
  description: AM name in Japanese.
746
  amNameEn:
747
  type: string
748
  example: 'XXX Asset Management'
749
  description: AM name in English.
750
  userId:
751
  type: string
752
  example: 'XXX@crednex.co.jp'
753
  default: User ID that registered this statement as AM
754
  apCode:
755
  type: string
756
  example: '00012'
757
  description: AP code. 5-digit number.
758
  apNameJa:
759
  type: string
760
  example: 'XXX 証券'
761
  description: AP Name in Japanese.
762
  apNameEn:
763
  type: string
764
  example: 'XXX Securities Co., Ltd.'
765
  description: AP Name in English.
766
  etfCode:
767
  type: string
768
  example: '12340'
769
  description: ETF fund code. 5-digit alphanumeric character.
770
  etfISINCode:
771
  type: string
772
  example: 'JP0000000000'
773
  description: ISIN code. 10-digit number.
774
  etfNameJa:
775
  type: string
776
  example: 'XXX ファンド'
777
  description: ETF fund name in Japanese.
778
  etfNameEn:
779
  type: string
780
  example: 'XXX fund'
781
  description: ETF fund name in English.
782
  creationOrRedemption:
783
  type: string
784
  example: 'C'
785
- description: Specify Creation or Redmption. 'C':Creation 'R':Redemption
786
  tbCode:
787
  type: string
788
  example: '00001'
789
  description: TB code. 5-digit number.
790
  tbNameJa:
791
  type: string
792
  example: 'XXX 信託銀行'
793
  description: TB name in Japanese.
794
  tbNameEn:
795
  type: string
796
  example: 'XXX Trust Bank Co., Ltd.'
797
  description: TB name in English.
798
  navPerShareCalculationDate:
799
  type: string
800
  format: date
801
  example: '2025-05-29'
802
  description: NAV per share calculation date.
803
  statementFixingDate:
804
  type: string
805
  format: date
806
  example: '2025-05-29'
807
  description: Statement fixing date.
808
  settlementDate:
809
  type: string
810
  format: date
811
  example: '2025-05-31'
812
  description: Settlement date.
813
  trustEstablishmentOrCancellationDate:
814
  type: string
815
  format: date
816
  example: '2025-05-30'
817
  description: Trust establishment or cancellation date.
818
  etfNavPerShare:
819
  type: string
820
  example: '12345678901234.1234'
821
- description: ETF nav per share.
822
- etfPurchaseOrCancellationPrice:
823
- type: string
824
- example: '12345678901234.1234'
825
- description: ETF purchase or cancellation price.
826
  numberOfShares:
827
  type: integer
828
  example: 10000
829
- format: int32
830
  description: Number of shares the client ordered.
831
  numberOfSharesOfNewRecordOrScheduledDeletion:
832
  type: integer
833
  example: 123456789012345
834
  format: int64
835
  description: The number of shares of new record or scheduled deletion.
836
  etfNetAssetValue:
837
  type: string
838
  example: '12345678901234.1234'
839
  description: ETF net asset value.
840
- executionCosts:
841
- type: string
842
- description: Execution cost of this creation/redemption for AP.
843
  optionalInputItemName1:
844
  type: string
845
  description: Name of optional item.
846
- totalPaymentAmount:
847
- type: string
848
- example: '123456789012345678'
849
- description: Total payment of this creation/redemption for AP.
850
  optionalInputItemName2:
851
  type: string
852
  optionalInputItemContent2:
853
  type: string
854
  description: Contents of optional item.
855
  optionalInputItemName3:
856
  type: string
857
  optionalInputItemContent3:
858
  type: string
859
  optionalInputItemName4:
860
  type: string
861
- statementType:
862
- type: string
863
- enum:
864
- - 'CreatedByAM'
865
- - 'CreatedByCredNex'
866
- description: |
867
- CreatedByAM: This statement is registered by AM, and transitions to 'StatementFixed' status by the deadline of the statement fixing date.
868
-
869
- CreatedByCredNex: This statement is automatically created by CredNex because the application for the statement transitions to 'Accepted', but does not transition to 'StatementFixed' status by the deadline of the statement fixing date.
870
-
871
- If the application is non-cleared, the return value for this item will be an empty string.
872
  optionalInputItemName5:
873
  type: string
874
- dvpSettlementPrice:
875
- type: string
876
- example: '12345678901234.1234'
877
- description: DVP settlement price calculated on the application date. If the application is non-cleared, the return value for this item will be an empty string.
878
  optionalInputItemName6:
879
  type: string
880
  optionalInputItemContent6:
881
  type: string
882
  optionalInputItemName7:
883
  type: string
884
  optionalInputItemContent7:
885
  type: string
886
  optionalInputItemName8:
887
  type: string
888
  optionalInputItemContent8:
889
  type: string
890
  optionalInputItemName9:
891
  type: string
892
  optionalInputItemContent9:
893
  type: string
894
  optionalInputItemName10:
895
  type: string
896
  optionalInputItemContent10:
897
- type: string
898
  notes:
899
  type: string
900
  description: Notices by AM for AP.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
901
  BaseSchedule:
902
  type: object
903
  description: Schedule configuration depends on clearingType. For "Clearing", only clearing.schedule is set and nonClearing.schedule is null. For "Non-Clearing", only nonClearing.schedule is set and clearing.schedule is null. For "Selectable", both clearing.schedule and nonClearing.schedule are set.
904
  nullable: true
905
  properties:
906
  navPerShareCalculationDate:
907
  type: integer
908
  description: NAV per share calculation date. It is counted from the trade date (dayT). If it is '0', T+0 is NAV per share calculation date.
909
  example: 0
910
  statementFixingDate:
911
  type: integer
912
  description: Statement fixing date. It is counted from the trade date (dayT).
913
  example: 1
914
  settlementDate:
915
  type: integer
916
  description: Settlement date. It is counted from the trade date (dayT).
917
  example: 2
918
  CreationSchedule:
919
  allOf:
920
  - $ref: "#/components/schemas/BaseSchedule"
921
  - type: object
922
  properties:
923
  trustEstablishmentDate:
924
  type: integer
925
  description: Trust establishment date in case of creation. It is counted from the trade date (dayT).
926
  example: 2
927
  RedemptionSchedule:
928
  allOf:
929
  - $ref: "#/components/schemas/BaseSchedule"
930
  - type: object
931
  properties:
932
  trustCancellationDate:
933
  type: integer
934
  description: Trust cancellation date in case of redemption. It is counted from the trade date (dayT).
935
  example: 2
936
  parameters:
937
  applicationId:
938
  name: applicationId
939
  in: path
940
  required: true
941
  description: Application ID
942
  schema:
943
  type: string
944
  example: '2024123100010001'
945
  statementFixingDate:
946
  name: statementFixingDate
947
  in: query
948
  required: false
949
  description: Statement fixing date. Default is today (JST).
950
  schema:
951
  type: string
952
  format: date
953
  example: '2025-05-29'
954
  tags:
955
  - name: applications
956
  description: Create/Approve creation/redemption applications
957
  - name: information
958
  description: Get information related to ETF creation/redemption operations
 
1
  openapi: 3.0.0
2
  servers:
3
  - url: https://crednex.jpx.co.jp/api/v1
4
  description: Production server
5
  - url: https://stg.crednex.jpx.co.jp/api/v1
6
  description: Staging server
7
  info:
8
  title: ETF Creation Redemption Platform (CredNex) API Specification
9
+ version: 1.2.3
10
  description: |
11
  ## Outline
12
 
13
  #### Production Environment
14
 
15
  URL: https://crednex.jpx.co.jp/api/v1
16
 
17
  Available Time: Weekdays 7:00 a.m-10:00 p.m (JST)
18
 
19
  #### Demo Environment
20
 
21
  URL: https://stg.crednex.jpx.co.jp/api/v1
22
 
23
  Available Time: Weekdays 7:00 a.m-10:00 p.m (JST)
24
 
25
 
26
  #### Network
27
 
28
  - The access route is provided only via the Internet.
29
  - Global IP for each environment of this system is not fixed.
30
 
31
  ## Preparations
32
 
33
 
34
  #### API Key
35
 
36
  Getting an API key is required.
37
  An API key is an unique key for each API user.
38
  It is used for this service to identify API users.
39
  Any API users who wish to use the APIs on this service must request TSE to issue API keys in advance.
40
  The API key should be set in the X-API-KEY in header every time you send an API call.
41
 
42
 
43
  #### IP Address Whitelisting
44
 
45
  You must submit the global IP address of the system making API calls to TSE.
46
  All API keys are linked to global IP addresses, and API calls from IP addresses not submitted in advance will not be accepted.
47
 
48
 
49
  #### Rate Limits
50
 
51
+ This API uses the token bucket algorithm for rate limiting.
52
+ If requests exceed the rate limit defined by the following settings, the bucket will be emptied and the user will receive an error response until tokens are replenished.
53
+ - Rate: 5 tokens per second
54
+ - Burst: 10 tokens
55
 
56
+ Rate: The speed at which tokens are added to the bucket.
57
 
58
+ Burst: The maximum number of tokens that can be stored in the bucket.
59
+
60
+ Overly frequent access is prohibited as stated in the Terms and Conditions. If such behavior is detected, TSE may issue a warning to the user.
 
 
 
 
 
 
61
 
62
+ ## Authorization
63
 
64
+ |Method|Endpoint|MM|AP (Agency)|AP (Prop)|AM|
65
+ |:----|:----|:----|:----|:----|:----|
66
+ |GET|/applications<br>/applications/{applicationId}|Available|Available|Available|Available|
67
+ |GET|/statements/{applicationId}<br>/issues<br>/issues/blackout<br>/pcf<br>/pcf/{pcfNumber}|Available|Available|Available|Available|
68
+ |PATCH|/issues|N/A|N/A|N/A|Available|
69
+ |POST|/applications|Available|N/A|Available|N/A|
70
+ |PUT|/applications/{applicationId}/approve|N/A|Available|Available|Available|
71
+ |PUT|/applications/{applicationId}/deny|N/A|Available|Available|Available|
72
+ |PUT|/applications/{applicationId}/approveCancellationRequest|N/A|Available|Available|Available|
73
+ |PUT|/applications/{applicationId}/denyCancellationRequest|N/A|Available|Available|Available|
74
+ |PUT|/applications/{applicationId}/cancellationRequest|Available|N/A|Available|N/A|
75
+
76
+
77
  paths:
78
  /applications:
79
  get:
80
  summary: Get applicationId of creation and redemption application
81
  description: Get applicationId for which the user has permissions to view
82
  operationId: getApplicationIds
83
  tags:
84
  - applications
85
  parameters:
86
  - name: applicationDate
87
  in: query
88
  schema:
89
  type: string
90
  format: date
91
+ description: Application date.
92
  - name: statementFixingDate
93
  in: query
94
  schema:
95
  type: string
96
  format: date
97
+ description: Statement fixing date.
98
  - name: status
99
  in: query
100
  schema:
101
  type: string
102
  description: Specify the status of the creation and redemption applications
103
+ enum:
104
+ - "ApplicationInProcessAP"
105
+ - "ApplicationInProcessAM"
106
+ - "Accepted"
107
+ - "StatementInProcessTB"
108
+ - "StatementReturnedForRevisionAM"
109
+ - "StatementFixed"
110
+ - "CancelRequestInProcessAP"
111
+ - "CancelRequestInProcessAM"
112
+ - "Canceled"
113
  responses:
114
  '200':
115
  description: Success operation
116
  content:
117
  application/json:
118
  schema:
119
  type: object
120
  properties:
121
  applications:
122
  type: array
123
  items:
124
  type: object
125
  properties:
126
  id:
127
  type: string
128
  example: '2024123100010001'
129
  description: Application ID
130
  status:
131
  type: string
132
  enum:
133
  - "ApplicationInProcessAP"
134
  - "ApplicationInProcessAM"
135
  - "Accepted"
136
  - "StatementInProcessTB"
137
  - "StatementReturnedForRevisionAM"
138
  - "StatementFixed"
139
  - "CancelRequestInProcessAP"
140
  - "CancelRequestInProcessAM"
141
+ - "Canceled"
142
+ createdAt:
143
+ type: string
144
+ example: '2025-04-15T12:34:56+09:00'
145
+ description: The time when the applicant registered this application.
146
  hasMore:
147
  type: boolean
148
  example: false
149
  description: Whether there are more than 1,000 application IDs. If true, please send a request again by narrowing down the conditions such as application date, statement fixing date, and status.
150
  post:
151
  summary: Register for your creation/redemption application
152
  description: |
153
  Fill in the information required to apply for creation/redemption and register your application.
154
 
155
  If `isClearing` is not specified, the CredNex system will automatically complete the value of `isClearing` for the application.
156
  The value set depends on `clearingType` of the issue being applied for.
157
  If the `clearingType` in each issue's basic information is Clearing or Selectable, `isClearing` will be set to true and the application will be registered as cleared by JSCC.
158
  If the `clearingType` is Non-Clearing, `isClearing` will be set to false and the application will be registered as non-cleared by JSCC.
159
  operationId: registerApplication
160
  tags:
161
  - applications
162
  requestBody:
163
  required: true
164
  content:
165
  application/json:
166
  schema:
167
  $ref: '#/components/schemas/Application'
168
  responses:
169
  '201':
170
  description: Created
171
  content:
172
  application/json:
173
  schema:
174
  type: object
175
  properties:
176
  applicationId:
177
  type: string
178
  example: '2024123100010001'
179
  '400':
180
  description: "Bad Request"
181
  content:
182
  application/json:
183
  schema:
184
  type: object
185
  properties:
186
  message:
187
  type: string
188
  enum:
189
  - ETF code or AP code is incorrect.
190
  - Application date is incorrect.
191
  - Cut-off time for this ETF fund has already elapsed.
192
  - Number of shares is incorrect.
193
  - The number of digits in 'numberOfShares' is exceeded.
194
+ - Number of shares must be a minimum lot plus a multiple of the order unit.
195
  - Number of shares must be exceeded the minimum.
196
  - Number of shares must be an integer multiple of the trading unit. The trading unit is {trading unit}.
197
  - This issue can only be applied with clearing.
198
  - This issue can only be applied with non-clearing.
199
+ - You cannot apply for cash ETFs by specifying 'codesOfTreasuryStock'.
200
+ - "'codesOfTreasuryStock' must be specified as a 5-character alphanumeric code."
201
+ - "'codesOfTreasuryStock' must be specified for up to 5 stocks."
202
+ - "'codesOfTreasuryStock' contains duplicate codes."
203
+ - The value for 'position' in the custom field must be a number up to 9.
204
+ - The value for 'position' in the custom field is incorrect.
205
+ - The 'value' in the custom field is incorrect.
206
+ - The 'value' in the custom field must not exceed 50 characters.
207
+ - "'position' in the custom field contains duplicate numbers."
208
+ - Please specify either 'true' or 'false' for 'excludeTreasuryStockIfNotInPcf'.
209
+ - "'applicationDate' is incorrect."
210
+ - "'creationOrRedemption' is incorrect."
211
+ - "'isClearing' is incorrect."
212
+ - "'numberOfUnits' and 'numberOfShares' must be specified as an integer."
213
+ - "Please specify 'numberOfUnits' as 1 or greater."
214
+ - "The number of digits in 'numberOfUnits' is exceeded."
215
+ - "Please specify 'numberOfShares' as 1 or greater."
216
+ - "The number of digits in 'notes' is exceeded."
217
+ - "The combination of 'numberOfShares', 'numberOfUnits', and 'pcfNumber' is invalid. Please specify either 'numberOfShares' only, or both 'numberOfUnits' and 'pcfNumber'."
218
+ - Required fields are not completely filled in.
219
+ - "'applicationDate' is outside the handling period for this etfCode."
220
+ - "'applicationDate' is a blackout date."
221
+ - Application date is a blackout date.
222
+ - This ETF fund is out of handling period.
223
+ - "For the specified 'etfCode', 'applicationDate', and 'creationOrRedemption', you cannot apply by specifying 'numberOfShares'. Please specify both 'numberOfUnits' and 'pcfNumber', or choose different options."
224
+ - "For the specified 'etfCode', 'applicationDate', and 'creationOrRedemption', you cannot apply by specifying either 'numberOfUnits' or 'pcfNumber'. Please specify only 'numberOfShares' or choose different options."
225
+ - "'pcfNumber' is incorrect."
226
+ - "Cash ETF must be applied with 'numberOfShares'."
227
+ - "The estimated number of units exceeds 15 digits. Please re-specify 'numberOfUnits'."
228
+ - "You cannot specify 'codesOfTreasuryStock' to an issue code that does not exist in the PCF basket."
229
+ - "The AM does not allow values to be set in the custom fields. Please remove all values from the custom fields and try registering again."
230
+ - This issue is not available for clearing by JSCC. Please contact the CredNex team.
231
+ - This issue can only be applied with clearing for creation/redemption.
232
+ - This issue can only be applied with non-clearing for creation/redemption.
233
  example: 'ETF code or AP code is incorrect.'
234
  '403':
235
  description: 'Forbidden'
236
  content:
237
  application/json:
238
  schema:
239
  type: object
240
  properties:
241
  message:
242
  type: string
243
+ enum:
244
+ - You are not allowed to access this endpoint.
245
+ example: 'You are not allowed to access this endpoint.'
246
  /applications/{applicationId}:
247
  get:
248
  summary: Get detailed application information
249
  description: 'Specify the applicationId to get details of the applications that the user has permission to view.'
250
  parameters:
251
  - $ref: '#/components/parameters/applicationId'
252
  operationId: getApplicationDetails
253
  tags:
254
  - applications
255
  responses:
256
  '200':
257
  description: Success operation
258
  content:
259
  application/json:
260
  schema:
261
  $ref: '#/components/schemas/ApplicationInfo'
262
  '403':
263
  description: 'Forbidden'
264
  content:
265
  application/json:
266
  schema:
267
  type: object
268
  properties:
269
  message:
270
  type: string
271
+ example: 'You are not allowed to access this application.'
272
  /applications/{applicationId}/approve:
273
  put:
274
  summary: Approve a creation/redemption application
275
  parameters:
276
  - $ref: '#/components/parameters/applicationId'
277
+ description: |
278
+ Approve an application from market maker or AP.
279
+ APs can only approve applications with the status 'ApplicationInProcessAP'.
280
+ AMs can only approve applications with the status 'ApplicationInProcessAM'.
281
  operationId: approveApplication
282
  tags:
283
  - applications
284
  responses:
285
  '200':
286
  description: Success operation
287
  '400':
288
  description: 'Bad Request'
289
  content:
290
  application/json:
291
  schema:
292
  type: object
293
  properties:
294
  message:
295
  type: string
296
  enum:
297
  - This approval is not available for this application ID.
298
  - This application cannot be approved because it has exceeded the cut-off.
299
+ example: 'This approval is not available for this application ID.'
300
  '403':
301
  description: 'Forbidden'
302
  content:
303
  application/json:
304
  schema:
305
  type: object
306
  properties:
307
  message:
308
  type: string
309
+ enum:
310
+ - You are not allowed to access this application.
311
+ - You are not allowed to access this endpoint.
312
+ example: 'You are not allowed to access this application.'
313
  /applications/{applicationId}/deny:
314
  put:
315
  summary: Deny a creation/redemption application
316
  parameters:
317
  - $ref: '#/components/parameters/applicationId'
318
+ description: |
319
+ Deny an application from market maker or AP.
320
+ APs can only deny applications with the status 'ApplicationInProcessAP'.
321
+ AMs can only deny applications with the status 'ApplicationInProcessAM'.
322
  operationId: denyApplication
323
  tags:
324
  - applications
325
  responses:
326
  '200':
327
  description: Success operation
328
  '400':
329
  description: 'Bad Request'
330
  content:
331
  application/json:
332
  schema:
333
  type: object
334
  properties:
335
  message:
336
  type: string
337
+ example: 'This denial is not available for this application ID.'
338
  '403':
339
  description: 'Forbidden'
340
  content:
341
  application/json:
342
  schema:
343
  type: object
344
  properties:
345
  message:
346
  type: string
347
+ enum:
348
+ - You are not allowed to access this application.
349
+ - You are not allowed to access this endpoint.
350
+ example: 'You are not allowed to access this application.'
351
  /applications/{applicationId}/approveCancellationRequest:
352
  put:
353
  summary: Approve a cancellation request
354
  parameters:
355
  - $ref: '#/components/parameters/applicationId'
356
+ description: |
357
+ Approve a cancellation request from market maker or AP.
358
+ APs can only approve applications with the status 'CancelRequestInProcessAP'.
359
+ AMs can only approve applications with the status 'CancelRequestInProcessAM'.
360
  operationId: approveCancellationRequest
361
  tags:
362
  - applications
363
  responses:
364
  '200':
365
  description: Success operation
366
  '400':
367
  description: 'Bad Request'
368
  content:
369
  application/json:
370
  schema:
371
  type: object
372
  properties:
373
  message:
374
  type: string
375
+ example: 'This approval is not available for this application ID.'
376
  '403':
377
  description: 'Forbidden'
378
  content:
379
  application/json:
380
  schema:
381
  type: object
382
  properties:
383
  message:
384
  type: string
385
+ enum:
386
+ - You are not allowed to access this application.
387
+ - You are not allowed to access this endpoint.
388
+ example: 'You are not allowed to access this application.'
389
  /applications/{applicationId}/denyCancellationRequest:
390
  put:
391
  summary: Deny a cancellation request
392
  parameters:
393
  - $ref: '#/components/parameters/applicationId'
394
+ description: |
395
+ Deny a cancellation request from market maker or AP.
396
+ APs can only deny applications with the status 'CancelRequestInProcessAP'.
397
+ AMs can only deny applications with the status 'CancelRequestInProcessAM'.
398
  operationId: denyCancellationRequest
399
  tags:
400
  - applications
401
  responses:
402
  '200':
403
  description: Success operation
404
  '400':
405
  description: 'Bad Request'
406
  content:
407
  application/json:
408
  schema:
409
  type: object
410
  properties:
411
  message:
412
  type: string
413
+ example: 'This denial is not available for this application ID.'
414
  '403':
415
  description: 'Forbidden'
416
  content:
417
  application/json:
418
  schema:
419
  type: object
420
  properties:
421
  message:
422
  type: string
423
+ enum:
424
+ - You are not allowed to access this application.
425
+ - You are not allowed to access this endpoint.
426
+ example: 'You are not allowed to access this application.'
427
  /applications/{applicationId}/cancellationRequest:
428
  put:
429
  summary: Request APs to cancel an application
430
  parameters:
431
  - $ref: '#/components/parameters/applicationId'
432
  description: 'Request APs to cancel a registered application.'
433
  operationId: cancellationRequest
434
  tags:
435
  - applications
436
  responses:
437
  '200':
438
  description: Success operation
439
  '400':
440
  description: 'Bad Request'
441
  content:
442
  application/json:
443
  schema:
444
  type: object
445
  properties:
446
  message:
447
  type: string
448
+ enum:
449
+ - Cancellation is not available for this application ID.
450
+ - Cut-off time for this ETF fund has already elapsed.
451
  example: 'Cancellation is not available for this application ID.'
452
  '403':
453
  description: 'Forbidden'
454
  content:
455
  application/json:
456
  schema:
457
  type: object
458
  properties:
459
  message:
460
  type: string
461
+ enum:
462
+ - You are not allowed to access this application.
463
+ - You are not allowed to access this endpoint.
464
+ example: 'You are not allowed to access this application.'
465
  /statements/{applicationId}:
466
  get:
467
  summary: Get statement data
468
+ description: Get statement data. The layout of the response body differs between cash statements and in-kind statements.
469
+ operationId: getStatement
470
  parameters:
471
  - $ref: '#/components/parameters/applicationId'
472
  tags:
473
  - applications
474
  responses:
475
  '200':
476
  description: Success operation
477
  content:
478
  application/json:
479
  schema:
480
  $ref: '#/components/schemas/Statements'
481
  '400':
482
  description: 'Bad Request'
483
  content:
484
  application/json:
485
  schema:
486
  type: object
487
  properties:
488
  message:
489
  type: string
490
+ example: 'This request is not available for this application ID.'
491
  '403':
492
  description: 'Forbidden'
493
  content:
494
  application/json:
495
  schema:
496
  type: object
497
  properties:
498
  message:
499
  type: string
500
+ example: 'You are not allowed to access this application.'
501
  /issues:
502
+ patch:
503
+ summary: Update issue details
504
+ description: |
505
+ Partially update issue details. AM can modify the order unit and minimum number of shares of its own issue.
506
+ Fields not included in the request body will remain unchanged.
507
+ operationId: UpdateIssueDetails
508
+ tags:
509
+ - information
510
+ requestBody:
511
+ required: true
512
+ content:
513
+ application/json:
514
+ schema:
515
+ type: object
516
+ properties:
517
+ issues:
518
+ type: array
519
+ items:
520
+ type: object
521
+ properties:
522
+ etfCode:
523
+ type: string
524
+ description: ETF fund code. 5-digit alphanumeric character.
525
+ example: '12340'
526
+ creation:
527
+ type: object
528
+ properties:
529
+ orderUnit:
530
+ type: integer
531
+ description: Order unit in case of creation. If it is 10000, applicants can only request for an integer multiple of 10,000 as number of shares.
532
+ example: 10000
533
+ minimumNumberOfShares:
534
+ type: integer
535
+ description: Minimum number of shares in case of creation. If it is 30000, applicants can request in quantities of 30,000 or more.
536
+ example: 30000
537
+ redemption:
538
+ type: object
539
+ properties:
540
+ orderUnit:
541
+ type: integer
542
+ description: Order unit in case of redemption. If it is 10000, applicants can only request for an integer multiple of 10,000 as number of shares.
543
+ example: 10000
544
+ minimumNumberOfShares:
545
+ type: integer
546
+ description: Minimum number of shares in case of redemption. If it is 30000, applicants can request in quantities of 30,000 or more.
547
+ example: 30000
548
+ responses:
549
+ '200':
550
+ description: Success operation
551
+ content:
552
+ application/json:
553
+ schema:
554
+ $ref: '#/components/schemas/Issues'
555
+ '400':
556
+ description: 'Bad Request'
557
+ content:
558
+ application/json:
559
+ schema:
560
+ type: object
561
+ properties:
562
+ message:
563
+ type: string
564
+ enum:
565
+ - The request body does not match the required JSON schema.
566
+ - "'etfCode' must be 5 characters long and contain only uppercase letters (A–Z) and digits (0–9)."
567
+ - "'orderUnit' must be an integer greater than 0."
568
+ - "The 'orderUnit' exceeds 15 digits. Please re-specify 'orderUnit'."
569
+ - "'minimumNumberOfShares' must be an integer greater than 0."
570
+ - "The 'minimumNumberOfShares' exceeds 15 digits. Please re-specify 'minimumNumberOfShares'."
571
+ example: 'The request body does not match the required JSON schema.'
572
+ '403':
573
+ description: 'Forbidden'
574
+ content:
575
+ application/json:
576
+ schema:
577
+ type: object
578
+ properties:
579
+ message:
580
+ type: string
581
+ example: 'You are not allowed to access this issue.'
582
  get:
583
  summary: Get basic information of each issue
584
  description: Get basic information of each issue.
585
+ operationId: getIssueInfo
586
  tags:
587
+ - information
588
+ responses:
589
  '200':
590
  description: Success operation
591
  content:
592
  application/json:
593
  schema:
594
  $ref: '#/components/schemas/Issues'
595
  /issues/blackout:
596
  get:
597
  summary: Get blackout dates of each issue
598
  description: Get blackout dates of each issue.
599
+ operationId: getBlackoutCalendar
600
  tags:
601
  - information
602
  responses:
603
  '200':
604
  description: Success operation
605
  content:
606
  application/json:
607
  schema:
608
  type: object
609
  properties:
610
  issues:
611
  type: array
612
  items:
613
  $ref: '#/components/schemas/Blackout'
614
+ /pcf:
615
+ get:
616
+ summary: Get PCF list
617
+ description: |
618
+ Get PCF list includes only those whose `expirationDate` is today or later.
619
+
620
+ If you want to retrieve the component stocks of a PCF, please request to `/pcf/{pcfNumber}`.
621
+
622
+ By setting query parameters `isToday` and `enabledStatus` to true,
623
+ you can retrieve all PCFs that are available for application today(based on JST).
624
+ operationId: getPcf
625
+ tags:
626
+ - information
627
+ parameters:
628
+ - name: isToday
629
+ in: query
630
+ description: Retrieve only PCFs for which the today date (based on JST) is between effectiveDate and expirationDate.
631
+ required: false
632
+ schema:
633
+ type: boolean
634
+ default: true
635
+ - name: enabledStatus
636
+ in: query
637
+ description: |
638
+ Retrieve PCFs filtered by their enabled status.
639
+ If `enabled`, only PCFs whose `isEnabled` value is true are retrieved.
640
+ If `disabled`, only PCFs whose `isEnabled` value is false are retrieved.
641
+ If `both` or not specified, PCFs with both true and false values for `isEnabled` are returned.
642
+ required: false
643
+ schema:
644
+ type: string
645
+ enum:
646
+ - enabled
647
+ - disabled
648
+ - both
649
+ default: both
650
+ - name: etfCode
651
+ in: query
652
+ description: Retrieve only PCFs linked to the specified ETF. If not specified, all ETFs are returned.
653
+ required: false
654
+ schema:
655
+ type: string
656
+ responses:
657
+ '200':
658
+ description: Success operation
659
+ content:
660
+ application/json:
661
+ schema:
662
+ type: object
663
+ properties:
664
+ pcf:
665
+ type: array
666
+ items:
667
+ $ref: '#/components/schemas/pcfHeader'
668
+ '400':
669
+ description: 'Bad Request'
670
+ content:
671
+ application/json:
672
+ schema:
673
+ type: object
674
+ properties:
675
+ message:
676
+ type: string
677
+ enum:
678
+ - This value of the query parameter is incorrect.
679
+ - "The query parameter 'etfCode' must be specified as a 5-digit value."
680
+ example: 'This value of the query parameter is incorrect.'
681
+ /pcf/{pcfNumber}:
682
+ get:
683
+ summary: Get PCF by specifying PCF number
684
+ description: Get PCF by specifying PCF number.
685
+ operationId: getPcfByPcfNumber
686
+ tags:
687
+ - information
688
+ parameters:
689
+ - name: pcfNumber
690
+ in: path
691
+ required: true
692
+ description: PCF number. 16-digit alphanumeric character.
693
+ schema:
694
+ type: string
695
+ example: 'P180125C13060001'
696
+ responses:
697
+ '200':
698
+ description: Success operation
699
+ content:
700
+ application/json:
701
+ schema:
702
+ $ref: '#/components/schemas/pcfIncludingComponentStocks'
703
+ '404':
704
+ description: Not Found
705
+ content:
706
+ application/json:
707
+ schema:
708
+ type: object
709
+ properties:
710
+ message:
711
+ type: string
712
+ example: "'pcfNumber' is incorrect."
713
  security:
714
  - ApiKeyAuth: []
715
  components:
716
  securitySchemes:
717
  ApiKeyAuth:
718
  type: apiKey
719
  in: header
720
  name: X-API-KEY
721
  schemas:
722
  Application:
723
+ allOf:
724
+ - type: object
725
+ required:
726
+ - applicationDate
727
+ - apCode
728
+ - etfCode
729
+ - creationOrRedemption
730
+ properties:
731
+ applicationDate:
732
+ type: string
733
+ format: date
734
+ description: Application date
735
+ example: '2025-04-15'
736
+ apCode:
737
+ type: string
738
+ description: AP code. 5-digit number.
739
+ example: '12345'
740
+ etfCode:
741
+ type: string
742
+ description: ETFfund code. 5-digit alphanumeric character.
743
+ example: '12340'
744
+ creationOrRedemption:
745
+ type: string
746
+ description: Specify Creation or Redemption. 'C':Creation 'R':Redemption
747
+ example: 'C'
748
+ codesOfTreasuryStock:
749
+ description: |
750
+ Array of Treasury Stock Codes.
751
+ type: array
752
+ minItems: 0
753
+ maxItems: 5
754
+ items:
755
+ type: string
756
+ example: '12340'
757
+ description: 5-digit code of treasury stock.
758
+ excludeTreasuryStockIfNotInPcf:
759
+ description: |
760
+ This parameter specifies the behavior when the specified treasury stock codes are not included in the PCF basket.
761
+ It specifies whether to exclude treasury stocks not included in the PCF basket before registering the application.
762
+
763
+ If the value is `false`, and any of the specified treasury stocks are not included in the PCF basket, the application registration will fail with an error.
764
+ If the value is `true`, the application registration will succeed after excluding from the specified treasury stocks those not included in the PCF.
765
+
766
+ For application requests for in-cash ETFs or in-kind ETFs without a specified PCF, no validation is performed to check whether the treasury stocks are included in the PCF basket.
767
+ In this case, the application registration will always succeed, regardless of the parameter value.
768
+ type: boolean
769
+ default: false
770
+
771
+ custom:
772
+ type: array
773
+ description: |
774
+ Custom fields for extensibility.
775
+ All values are visible to applicants, AP and AM.
776
+ minItems: 9
777
+ maxItems: 9
778
+ items:
779
+ type: object
780
+ properties:
781
+ position:
782
+ type: integer
783
+ description: Position is used to identify the field number
784
+ minimum: 1
785
+ maximum: 9
786
+ example: 1
787
+ value:
788
+ type: string
789
+ description: The value for this custom field
790
+ example: "CUSTOM_VALUE_001"
791
+ required:
792
+ - position
793
+ - value
794
+ example:
795
+ - position: 1
796
+ value: "Trading Account ABC"
797
+ - position: 2
798
+ value: "Reference-2025-001"
799
+ notes:
800
+ type: string
801
+ description: Notes from applicants to AP and AM.
802
+ example: 'string'
803
+ isClearing:
804
+ type: boolean
805
+ description: |
806
+ Cleared by JSCC or non-cleared. false:non-cleared true:cleared.
807
+
808
+ If `isClearing` is not specified, the CredNex system will automatically complete the value of `isClearing` for the application.
809
+ The value set depends on `clearingType` of the issue being applied for.
810
+ If the `clearingType` in each issue's basic information is Clearing or Selectable, `isClearing` will be set to true and the application will be registered as cleared by JSCC.
811
+ If the `clearingType` is Non-Clearing, `isClearing` will be set to false and the application will be registered as non-cleared by JSCC.
812
+ example: true
813
+ - oneOf:
814
+ - type: object
815
+ required:
816
+ - numberOfShares
817
+ properties:
818
+ numberOfShares:
819
+ type: integer
820
+ description: |
821
+ Number of shares.
822
+ Required when PCF number is NOT specified.
823
+ Cannot be used together with numberOfUnits.
824
+ example: 10000
825
+ format: int64
826
+ - type: object
827
+ required:
828
+ - pcfNumber
829
+ - numberOfUnits
830
+ properties:
831
+ pcfNumber:
832
+ type: string
833
+ description: PCF number. 16-digit alphanumeric character.
834
+ example: 'P180125C13060001'
835
+ numberOfUnits:
836
+ type: integer
837
+ description: |
838
+ Number of Units.
839
+ Required when PCF number is specified.
840
+ Cannot be used together with numberOfShares.
841
+ example: 10
842
+ format: int64
843
+ ApplicationInfo:
844
  type: object
845
  properties:
846
+ status:
847
+ type: string
848
+ enum:
849
+ - "ApplicationInProcessAP"
850
+ - "ApplicationInProcessAM"
851
+ - "Accepted"
852
+ - "StatementInProcessTB"
853
+ - "StatementReturnedForRevisionAM"
854
+ - "StatementFixed"
855
+ - "CancelRequestInProcessAP"
856
+ - "CancelRequestInProcessAM"
857
+ - "Canceled"
858
+ example: "ApplicationInProcessAP"
859
+ description: Application status at the time.
860
  applicationDate:
861
  type: string
862
  format: date
863
  description: Application date
864
  example: '2025-04-15'
865
+ mmCode:
866
+ type: string
867
+ example: '12345'
868
+ description: |
869
+ MM code.
870
+ 5-digit number.
871
+ This value is visible to MM and AP(Agency).
872
+ This value is always null in the case of a request from AP(Prop) or AM.
873
  apCode:
874
  type: string
875
  description: AP code. 5-digit number.
876
  example: '12345'
877
  etfCode:
878
  type: string
879
+ description: ETF fund code. 5-digit alphanumeric character.
880
  example: '12340'
881
+ inKindOrInCash:
882
+ type: string
883
+ description: Specify in-kind or in-cash.
884
+ example: 'InKindCreationInKindRedemption'
885
+ enum:
886
+ - CashCreationCashRedemption
887
+ - InKindCreationInKindRedemption
888
  creationOrRedemption:
889
  type: string
890
+ description: Creation or Redemption. 'C':Creation 'R':Redemption
891
  example: 'C'
 
 
 
 
 
 
 
 
 
 
 
 
 
892
  isClearing:
893
  type: boolean
894
  description: |
895
  Cleared by JSCC or non-cleared. false:non-cleared true:cleared.
896
+ example: false
897
+ numberOfShares:
898
+ type: integer
899
+ description: |
900
+ Number of shares.
901
+ If PCF number is specified, the estimated number of shares is set.
902
+ The estimated number of shares is calculated as the PCF’s `estimatedNumberOfSharesPerUnit` multiplied by `numberOfUnits`.
903
+ If no PCF number is specified, the number of shares specified by the applicant is set.
904
+ example: 123456
905
+ format: int64
906
+ pcfNumber:
 
 
 
 
 
 
907
  type: string
908
+ nullable: true
909
+ description: PCF number. 16-digit alphanumeric character. If PCF number is not specified, this field is null.
910
+ example: 'P180125C13060001'
911
+ numberOfUnits:
912
+ type: integer
913
+ nullable: true
914
+ description: |
915
+ Number of Units.
916
+ If PCF number is not specified, this field is null.
917
+ example: 10
918
+ format: int64
 
 
 
 
 
 
 
919
  jasdecAccountInformation:
920
  type: string
921
  example: '1234567'
922
  description: JASDEC account information. 7-digit number.
923
  navPerShareCalculationDate:
924
  type: string
925
  format: date
926
  example: '2025-05-29'
927
  description: NAV per share calculation date.
928
  statementFixingDate:
929
  type: string
930
  format: date
931
  example: '2025-05-29'
932
  description: Statement fixing date.
933
  trustEstablishmentOrCancellationDate:
934
  type: string
935
  format: date
936
  example: '2025-05-30'
937
  description: Trust establishment or cancellation date.
938
  settlementDate:
939
  type: string
940
  format: date
941
  example: '2025-05-31'
942
  description: Settlement date.
943
  dvpClearingPrice:
944
  type: string
945
+ example: ''
946
  description: |
947
  DVP clearing price. Used only if an application is in cash ETF and cleared.
948
+ codesOfTreasuryStock:
949
+ description: |
950
+ Array of Treasury Stock Codes.
951
+ type: array
952
+ minItems: 0
953
+ maxItems: 5
954
+ items:
955
+ type: string
956
+ example: '12340'
957
+ description: 5-digit code of treasury stock.
958
+ custom:
959
+ type: array
960
+ description: |
961
+ Custom fields for extensibility.
962
+ All values are visible to applicants, AP and AM.
963
+ minItems: 9
964
+ maxItems: 9
965
+ items:
966
+ type: object
967
+ properties:
968
+ position:
969
+ type: integer
970
+ description: Position is used to identify the field number
971
+ minimum: 1
972
+ maximum: 9
973
+ example: 1
974
+ value:
975
+ type: string
976
+ description: The value for this custom field
977
+ example: "CUSTOM_VALUE_001"
978
+ required:
979
+ - position
980
+ - value
981
+ example:
982
+ - position: 1
983
+ value: "Trading Account ABC"
984
+ - position: 2
985
+ value: "Reference-2025-001"
986
+ - position: 3
987
+ value: ""
988
+ - position: 4
989
+ value: ""
990
+ - position: 5
991
+ value: ""
992
+ - position: 6
993
+ value: ""
994
+ - position: 7
995
+ value: ""
996
+ - position: 8
997
+ value: ""
998
+ - position: 9
999
+ value: ""
1000
+ notes:
1001
+ type: string
1002
+ description: Notes from applicants to AP and AM.
1003
+ example: 'string'
1004
+ createdAt:
1005
+ type: string
1006
+ example: '2025-04-15T12:34:56+09:00'
1007
+ description: The time when the applicant registered this application.
1008
  Issues:
1009
  type: object
1010
  properties:
1011
  issues:
1012
  type: array
1013
  items:
1014
  type: object
1015
  properties:
1016
  etfCode:
1017
  type: string
1018
  description: ETF fund code. 5-digit alphanumeric character.
1019
  example: '12340'
1020
  inKindOrInCash:
1021
  type: string
1022
  description: Specify in-kind or in-cash.
1023
  example: 'CashCreationCashRedemption'
1024
  enum:
1025
  - CashCreationCashRedemption
1026
  - InKindCreationInKindRedemption
 
1027
  etfNameJa:
1028
  type: string
1029
  description: ETF fund name in Japanese.
1030
  example: 'XXX ファンド'
1031
  etfNameEn:
1032
  type: string
1033
  description: ETF fund name in English.
1034
  example: 'XXX fund'
1035
+ cutoffTimeIncludingTreasuryStock:
1036
+ type: string
1037
+ description: Cut-off time (JST) for cases where the treasury stock of AP is included in the basket. This item is omitted for cash ETF.
1038
+ example: '14:30'
1039
  cutoffTimeExcludingTreasuryStock:
1040
  type: string
1041
  description: Cut-off time (JST) for cases where the treasury stock of AP is not included in the basket. All cut-off time for in cash ETF funds are placed in this field.
1042
  example: '15:30'
1043
  creation:
1044
  type: object
1045
  properties:
1046
  clearingType:
1047
  type: string
1048
  enum:
1049
  - Clearing
1050
  - Non-Clearing
1051
  - Selectable
1052
  description: It means whether this issue can be cleared by JSCC or not. For issues that are selectable, applicants can choose whether or not to cleared by JSCC when registering their application.
1053
  example: 'Clearing'
1054
  schedule:
1055
  type: object
1056
  properties:
1057
  clearing:
1058
  $ref: "#/components/schemas/CreationSchedule"
1059
  nonClearing:
1060
  $ref: "#/components/schemas/CreationSchedule"
1061
  example:
1062
  clearing:
1063
  navPerShareCalculationDate: 0
1064
  statementFixingDate: 1
1065
  trustEstablishmentDate: 2
1066
  settlementDate: 2
1067
  nonClearing: null
1068
  orderUnit:
1069
  type: integer
1070
  description: Order unit in case of creation. If it is 10000, applicants can only request for an integer multiple of 10,000 as number of shares.
1071
  example: 10000
1072
  minimumNumberOfShares:
1073
  type: integer
1074
  description: Minimum number of shares in case of creation. If it is 30000, applicants can request in quantities of 30,000 or more.
1075
  example: 30000
1076
  redemption:
1077
  type: object
1078
  properties:
1079
  clearingType:
1080
  type: string
1081
  enum:
1082
  - Clearing
1083
  - Non-Clearing
1084
  - Selectable
1085
  description: It means whether this issue can be cleared by JSCC or not. For issues that are selectable, applicants can choose whether or not to cleared by JSCC when registering their application.
1086
  example: 'Selectable'
1087
  schedule:
1088
  type: object
1089
  properties:
1090
  clearing:
1091
  $ref: "#/components/schemas/RedemptionSchedule"
1092
  nonClearing:
1093
  $ref: "#/components/schemas/RedemptionSchedule"
1094
  example:
1095
  clearing:
1096
  navPerShareCalculationDate: 0
1097
  statementFixingDate: 1
1098
  trustCancellationDate: 2
1099
  settlementDate: 2
1100
  nonClearing:
1101
  navPerShareCalculationDate: 0
1102
  statementFixingDate: 1
1103
  trustCancellationDate: 2
1104
  settlementDate: 2
1105
  orderUnit:
1106
  type: integer
1107
  description: Order unit in case of redemption. If it is 10000, applicants can only request for an integer multiple of 10,000 as number of shares.
1108
  example: 10000
1109
  minimumNumberOfShares:
1110
  type: integer
1111
  description: Minimum number of shares in case of redemption. If it is 30000, applicants can request in quantities of 30,000 or more.
1112
  example: 30000
1113
+ customInputAllowed:
1114
+ type: boolean
1115
+ description: |
1116
+ If true, applicants can specify any value in the optional custom fields when registering an application.
1117
+ If false, applicants cannot use the optional custom fields, and all applications will have these fields left blank.
1118
+ example: true
1119
  earlyRedemptionClause:
1120
  type: integer
1121
  description: The number of early redemption shares specified in the terms and conditions of an investment trust for each fund. This is an optional field.
1122
  example: 100000
1123
  issuersOptionalFundCode:
1124
  type: string
1125
  description: Fund code used by the issuer to identify the fund internally. This is an optional field.
1126
+ example: 'ABCD1234'
1127
  isinCode:
1128
  type: string
1129
  description: ISIN code. 12-digit alphanumeric character.
1130
  example: 'JP1234567890'
1131
  amCode:
1132
  type: string
1133
  description: AM code. 5-digit number.
1134
  example: '00123'
1135
  amNameJa:
1136
  type: string
1137
  description: AM name in Japanese.
1138
  example: 'XXX アセットマネジメント'
1139
  amNameEn:
1140
  type: string
1141
  description: AM name in English.
1142
  example: 'XXX Asset Management'
1143
  tbCode:
1144
  type: string
1145
  description: TB code. 5-digit number.
1146
  example: '00001'
1147
  tbNameJa:
1148
  type: string
1149
  description: TB name in Japanese.
1150
  example: 'XXX 信託銀行'
1151
  tbNameEn:
1152
  type: string
1153
  description: TB name in English.
1154
  example: 'XXX Trust Bank Co., Ltd.'
1155
  handlingPeriodFrom:
1156
  type: string
1157
  description: Start date of available period for handling.
1158
  example: '2024-12-03'
1159
  handlingPeriodTo:
1160
  type: string
1161
  description: End date of available period for handling. If it is null, the end date is undecided.
1162
  example: '2025-09-21'
1163
  DateList:
1164
  type: array
1165
  items:
1166
  type: string
1167
  format: date
1168
  example: '1992-12-02'
1169
  Blackout:
1170
  type: object
1171
  properties:
1172
  etfCode:
1173
  type: string
1174
  example: '12340'
1175
  creationBlackoutDates:
1176
  type: array
1177
  items:
1178
  type: string
1179
  format: date
1180
  example: '1992-12-02'
1181
  redemptionBlackoutDates:
1182
  type: array
1183
  items:
1184
  type: string
1185
  format: date
1186
  example: '1992-12-02'
 
1187
  Statements:
1188
+ oneOf:
1189
+ - $ref: '#/components/schemas/InKindStatements'
1190
+ - $ref: '#/components/schemas/CashStatements'
1191
+ discriminator:
1192
+ propertyName: inKindOrInCash
1193
+ mapping:
1194
+ InKindCreationInKindRedemption: '#/components/schemas/InKindStatements'
1195
+ CashCreationCashRedemption: '#/components/schemas/CashStatements'
1196
+ pcfHeader:
1197
+ type: object
1198
+ properties:
1199
+ pcfNumber:
1200
+ type: string
1201
+ description: PCF number. 16-digit alphanumeric character.
1202
+ example: "1234567890123456"
1203
+ createdAt:
1204
+ type: string
1205
+ description: The date and time this PCF was registered by AM.
1206
+ example: "2025-11-14T14:33:00+09:00"
1207
+ am:
1208
+ type: object
1209
+ description: Asset Management information.
1210
+ properties:
1211
+ code:
1212
+ type: string
1213
+ description: AM code. 5-digit number.
1214
+ example: "00123"
1215
+ nameJa:
1216
+ type: string
1217
+ description: AM name in Japanese.
1218
+ example: "XXX アセットマネジメント"
1219
+ nameEn:
1220
+ type: string
1221
+ description: AM name in English.
1222
+ example: "XXX Asset Management"
1223
+ fileName:
1224
+ type: string
1225
+ description: The file name of this PCF registered by AM, including the file extension.
1226
+ example: "Basket1.csv"
1227
+ etf:
1228
+ type: object
1229
+ description: ETF fund information.
1230
+ properties:
1231
+ code:
1232
+ type: string
1233
+ description: ETF fund code. 5-digit alphanumeric character.
1234
+ example: "12340"
1235
+ isinCode:
1236
+ type: string
1237
+ description: ISIN code. 12-digit alphanumeric character.
1238
+ example: "JP1234567890"
1239
+ nameJa:
1240
+ type: string
1241
+ description: ETF fund name in Japanese.
1242
+ example: "XXX ファンド"
1243
+ nameEn:
1244
+ type: string
1245
+ description: ETF fund name in English.
1246
+ example: "XXX fund"
1247
+ creationOrRedemption:
1248
+ type: string
1249
+ description: Specify Creation or Redemption. 'C':Creation 'R':Redemption
1250
+ example: "C"
1251
+ estimatedNumberOfSharesPerUnit:
1252
+ type: integer
1253
+ description: Estimated number of ETF shares per 1 unit.
1254
+ example: 123456789012345
1255
+ basketName:
1256
+ type: string
1257
+ description: Basket name of this PCF registered by AM.
1258
+ isEnabled:
1259
+ type: boolean
1260
+ description: |
1261
+ This flag indicates whether this PCF can be specified at the time of application for creation or redemption.
1262
+ If true, applications specifying this PCF are allowed.
1263
+ If false, either the validity period has expired or this PCF has been invalidated by AM,
1264
+ and applications specifying this PCF are not allowed.
1265
+ example: true
1266
+ effectiveDate:
1267
+ type: string
1268
+ format: date
1269
+ description: Effective date of this PCF.
1270
+ example: "2025-11-12"
1271
+ expirationDate:
1272
+ type: string
1273
+ format: date
1274
+ description: Expiration date of this PCF.
1275
+ example: "2025-11-14"
1276
+ optionalInputItem:
1277
+ type: array
1278
+ minItems: 5
1279
+ maxItems: 5
1280
+ items:
1281
+ type: object
1282
+ properties:
1283
+ position:
1284
+ type: integer
1285
+ description: Position is used to identify the field number
1286
+ minimum: 1
1287
+ maximum: 5
1288
+ example: 1
1289
+ name:
1290
+ type: string
1291
+ content:
1292
+ type: string
1293
+ example:
1294
+ - position: 1
1295
+ name: "Name1"
1296
+ content: "Content1"
1297
+ - position: 2
1298
+ name: "Name2"
1299
+ content: "Content2"
1300
+ - position: 3
1301
+ name: ""
1302
+ content: ""
1303
+ - position: 4
1304
+ name: ""
1305
+ content: ""
1306
+ - position: 5
1307
+ name: ""
1308
+ content: ""
1309
+ notes:
1310
+ type: string
1311
+ description: Notes.
1312
+ example: "string"
1313
+ pcfIncludingComponentStocks:
1314
+ allOf:
1315
+ - $ref: '#/components/schemas/pcfHeader'
1316
+ - type: object
1317
+ properties:
1318
+ componentStocks:
1319
+ type: array
1320
+ description: Component Stocks.
1321
+ items:
1322
+ type: object
1323
+ properties:
1324
+ code:
1325
+ type: string
1326
+ description: Issue Code.
1327
+ example: "12340"
1328
+ isinCode:
1329
+ type: string
1330
+ description: ISIN Code.
1331
+ example: "JP1111111111"
1332
+ name:
1333
+ type: string
1334
+ description: Issue Name.
1335
+ example: "XXX 株式"
1336
+ cashSettledIssueType:
1337
+ type: string
1338
+ enum:
1339
+ - applicable
1340
+ - notApplicable
1341
+ - unspecified
1342
+ description: |
1343
+ The flag when an individual component stock is applicable for cash settlement.<br>
1344
+ notApplicable: Not applicable for cash settlement<br>
1345
+ applicable: Applicable for cash settlement<br>
1346
+ unspecified: Unspecified by AM
1347
+ example: applicable
1348
+ numberOfShares:
1349
+ type: integer
1350
+ nullable: true
1351
+ description: Number of Shares.
1352
+ example: 123456789012345
1353
+ notes:
1354
+ type: string
1355
+ description: Individual Issue Optional Input Item.
1356
+ example: "notes"
1357
+ StatementsBase:
1358
  type: object
1359
  properties:
1360
+ inKindOrInCash:
1361
+ type: string
1362
+ description: Specify in-kind or in-cash.
1363
+ example: 'InKindCreationInKindRedemption'
1364
  applicationId:
1365
  type: string
1366
  example: '2024123100010001'
1367
  description: Application ID
1368
  pcfNumber:
1369
  type: string
1370
  example: '1234567890123456'
1371
  description: PCF number. 16-digit alphanumeric character.
1372
  amCode:
1373
  type: string
1374
  example: '00123'
1375
  description: AM code. 5-digit number.
1376
  amNameJa:
1377
  type: string
1378
  example: 'XXX アセットマネジメント'
1379
  description: AM name in Japanese.
1380
  amNameEn:
1381
  type: string
1382
  example: 'XXX Asset Management'
1383
  description: AM name in English.
1384
  userId:
1385
  type: string
1386
  example: 'XXX@crednex.co.jp'
1387
  default: User ID that registered this statement as AM
1388
  apCode:
1389
  type: string
1390
  example: '00012'
1391
  description: AP code. 5-digit number.
1392
  apNameJa:
1393
  type: string
1394
  example: 'XXX 証券'
1395
  description: AP Name in Japanese.
1396
  apNameEn:
1397
  type: string
1398
  example: 'XXX Securities Co., Ltd.'
1399
  description: AP Name in English.
1400
  etfCode:
1401
  type: string
1402
  example: '12340'
1403
  description: ETF fund code. 5-digit alphanumeric character.
1404
  etfISINCode:
1405
  type: string
1406
  example: 'JP0000000000'
1407
  description: ISIN code. 10-digit number.
1408
  etfNameJa:
1409
  type: string
1410
  example: 'XXX ファンド'
1411
  description: ETF fund name in Japanese.
1412
  etfNameEn:
1413
  type: string
1414
  example: 'XXX fund'
1415
  description: ETF fund name in English.
1416
  creationOrRedemption:
1417
  type: string
1418
  example: 'C'
1419
+ description: Specify Creation or Redemption. 'C':Creation 'R':Redemption
1420
  tbCode:
1421
  type: string
1422
  example: '00001'
1423
  description: TB code. 5-digit number.
1424
  tbNameJa:
1425
  type: string
1426
  example: 'XXX 信託銀行'
1427
  description: TB name in Japanese.
1428
  tbNameEn:
1429
  type: string
1430
  example: 'XXX Trust Bank Co., Ltd.'
1431
  description: TB name in English.
1432
  navPerShareCalculationDate:
1433
  type: string
1434
  format: date
1435
  example: '2025-05-29'
1436
  description: NAV per share calculation date.
1437
  statementFixingDate:
1438
  type: string
1439
  format: date
1440
  example: '2025-05-29'
1441
  description: Statement fixing date.
1442
  settlementDate:
1443
  type: string
1444
  format: date
1445
  example: '2025-05-31'
1446
  description: Settlement date.
1447
  trustEstablishmentOrCancellationDate:
1448
  type: string
1449
  format: date
1450
  example: '2025-05-30'
1451
  description: Trust establishment or cancellation date.
1452
  etfNavPerShare:
1453
  type: string
1454
  example: '12345678901234.1234'
1455
+ description: |
1456
+ For an in-kind statement, this item is mandatory and represents the NAV per ETF share.
1457
+ In a cash statement, this item may not be registered from the AM and the value may be left blank.
1458
+ In that case, `etfPurchaseOrCancellationPrice` is a mandatory item from the AM and its value is stored.
1459
+ If you need to reference the price, use the value of `etfPurchaseOrCancellationPrice`.
1460
  numberOfShares:
1461
  type: integer
1462
  example: 10000
1463
+ format: int64
1464
  description: Number of shares the client ordered.
1465
  numberOfSharesOfNewRecordOrScheduledDeletion:
1466
  type: integer
1467
  example: 123456789012345
1468
  format: int64
1469
  description: The number of shares of new record or scheduled deletion.
1470
  etfNetAssetValue:
1471
  type: string
1472
  example: '12345678901234.1234'
1473
  description: ETF net asset value.
 
 
 
1474
  optionalInputItemName1:
1475
  type: string
1476
  description: Name of optional item.
 
 
 
 
1477
  optionalInputItemName2:
1478
  type: string
1479
  optionalInputItemContent2:
1480
  type: string
1481
  description: Contents of optional item.
1482
  optionalInputItemName3:
1483
  type: string
1484
  optionalInputItemContent3:
1485
  type: string
1486
  optionalInputItemName4:
1487
  type: string
 
 
 
 
 
 
 
 
 
 
 
1488
  optionalInputItemName5:
1489
  type: string
 
 
 
 
1490
  optionalInputItemName6:
1491
  type: string
1492
  optionalInputItemContent6:
1493
  type: string
1494
  optionalInputItemName7:
1495
  type: string
1496
  optionalInputItemContent7:
1497
  type: string
1498
  optionalInputItemName8:
1499
  type: string
1500
  optionalInputItemContent8:
1501
  type: string
1502
  optionalInputItemName9:
1503
  type: string
1504
  optionalInputItemContent9:
1505
  type: string
1506
  optionalInputItemName10:
1507
  type: string
1508
  optionalInputItemContent10:
1509
+ type: string
1510
  notes:
1511
  type: string
1512
  description: Notices by AM for AP.
1513
+ InKindStatements:
1514
+ allOf:
1515
+ - $ref: '#/components/schemas/StatementsBase'
1516
+ - type: object
1517
+ properties:
1518
+ inKindOrInCash:
1519
+ type: string
1520
+ description: Specify in-kind or in-cash.
1521
+ example: 'InKindCreationInKindRedemption'
1522
+ enum:
1523
+ - InKindCreationInKindRedemption
1524
+ residualNumberOfEtfSharesToBeReturned:
1525
+ type: integer
1526
+ example: 10000
1527
+ format: int64
1528
+ description: Residual Number of ETF Shares to be Returned.
1529
+ totalPaymentAmountInCreation:
1530
+ type: integer
1531
+ example: 10000
1532
+ format: int64
1533
+ description: Total Payment Amount in Creation.
1534
+ basketValuation:
1535
+ type: string
1536
+ example: '12345678901234.1234'
1537
+ description: Basket Valuation.
1538
+ cashSettledIssues:
1539
+ type: array
1540
+ description: Cash-settled Issues.
1541
+ minItems: 10
1542
+ maxItems: 10
1543
+ items:
1544
+ type: object
1545
+ properties:
1546
+ position:
1547
+ type: integer
1548
+ description: Position is used to identify the field number
1549
+ minimum: 1
1550
+ maximum: 10
1551
+ example: 1
1552
+ code:
1553
+ type: string
1554
+ description: Cash-settled Issue Code.
1555
+ example: "12340"
1556
+ name:
1557
+ type: string
1558
+ description: Cash-settled Issue Name.
1559
+ example: "XXX 株式"
1560
+ numberOfShares:
1561
+ type: integer
1562
+ nullable: true
1563
+ format: int64
1564
+ description: Cash-settled Issue Quantity.
1565
+ example: 123456789012345
1566
+ valuationPrice:
1567
+ type: string
1568
+ description: Cash-settled Issue Valuation Price.
1569
+ example: "12345678901234.1234"
1570
+ totalAmount:
1571
+ type: string
1572
+ description: Cash-settled Issue Total Amount.
1573
+ example: "12345678901234.1234"
1574
+ required:
1575
+ - position
1576
+ example:
1577
+ - position: 1
1578
+ code: "12340"
1579
+ name: "XXX 株式"
1580
+ numberOfShares: 100000
1581
+ valuationPrice: "12345678901234.1234"
1582
+ totalAmount: "12345678901234.1234"
1583
+ optionalInputItemContent1:
1584
+ type: string
1585
+ optionalInputItemContent4:
1586
+ type: string
1587
+ optionalInputItemContent5:
1588
+ type: string
1589
+ componentStocks:
1590
+ type: array
1591
+ description: Component Stocks.
1592
+ items:
1593
+ type: object
1594
+ properties:
1595
+ code:
1596
+ type: string
1597
+ description: Issue Code.
1598
+ example: "12340"
1599
+ isinCode:
1600
+ type: string
1601
+ description: ISIN Code.
1602
+ example: "JP1111111111"
1603
+ name:
1604
+ type: string
1605
+ description: Issue Name.
1606
+ example: "XXX 株式"
1607
+ numberOfShares:
1608
+ type: integer
1609
+ format: int64
1610
+ description: Number of Shares.
1611
+ example: 123456789012345
1612
+ stockPrice:
1613
+ type: string
1614
+ description: Stock Price.
1615
+ example: "12345678901234.1234"
1616
+ individualIssueTotalMarketValue:
1617
+ type: string
1618
+ description: Individual Issue Total Market Value.
1619
+ example: "12345678901234.1234"
1620
+ notes:
1621
+ type: string
1622
+ description: Individual Issue Optional Input Item.
1623
+ example: "string"
1624
+ CashStatements:
1625
+ allOf:
1626
+ - $ref: '#/components/schemas/StatementsBase'
1627
+ - type: object
1628
+ properties:
1629
+ inKindOrInCash:
1630
+ type: string
1631
+ description: Specify in-kind or in-cash.
1632
+ example: 'CashCreationCashRedemption'
1633
+ enum:
1634
+ - CashCreationCashRedemption
1635
+ etfPurchaseOrCancellationPrice:
1636
+ type: string
1637
+ example: '12345678901234.1234'
1638
+ description: |
1639
+ The price per ETF unit obtained by adding or subtracting execution costs (spreads) and other fees to or from the NAV per ETF unit is set.
1640
+ In a cash statement, this is a mandatory item that must always be registered by the AM, and its value is stored.
1641
+ When you need to reference the NAV in a cash statement, use this item.
1642
+ executionCosts:
1643
+ type: string
1644
+ description: Execution cost of this creation/redemption for AP.
1645
+ totalPaymentAmount:
1646
+ type: string
1647
+ example: '123456789012345678'
1648
+ description: Total payment of this creation/redemption for AP.
1649
+ statementType:
1650
+ type: string
1651
+ enum:
1652
+ - 'CreatedByAM'
1653
+ - 'CreatedByCredNex'
1654
+ description: |
1655
+ CreatedByAM: This statement is registered by AM, and transitions to 'StatementFixed' status by the deadline of the statement fixing date.
1656
+
1657
+ CreatedByCredNex: This statement is automatically created by CredNex because the application for the statement transitions to 'Accepted', but does not transition to 'StatementFixed' status by the deadline of the statement fixing date.
1658
+
1659
+ If the application is non-cleared, the return value for this item will be an empty string.
1660
+ dvpSettlementPrice:
1661
+ type: string
1662
+ example: '12345678901234.1234'
1663
+ description: DVP settlement price calculated on the application date. If the application is non-cleared, the return value for this item will be an empty string.
1664
+
1665
  BaseSchedule:
1666
  type: object
1667
  description: Schedule configuration depends on clearingType. For "Clearing", only clearing.schedule is set and nonClearing.schedule is null. For "Non-Clearing", only nonClearing.schedule is set and clearing.schedule is null. For "Selectable", both clearing.schedule and nonClearing.schedule are set.
1668
  nullable: true
1669
  properties:
1670
  navPerShareCalculationDate:
1671
  type: integer
1672
  description: NAV per share calculation date. It is counted from the trade date (dayT). If it is '0', T+0 is NAV per share calculation date.
1673
  example: 0
1674
  statementFixingDate:
1675
  type: integer
1676
  description: Statement fixing date. It is counted from the trade date (dayT).
1677
  example: 1
1678
  settlementDate:
1679
  type: integer
1680
  description: Settlement date. It is counted from the trade date (dayT).
1681
  example: 2
1682
  CreationSchedule:
1683
  allOf:
1684
  - $ref: "#/components/schemas/BaseSchedule"
1685
  - type: object
1686
  properties:
1687
  trustEstablishmentDate:
1688
  type: integer
1689
  description: Trust establishment date in case of creation. It is counted from the trade date (dayT).
1690
  example: 2
1691
  RedemptionSchedule:
1692
  allOf:
1693
  - $ref: "#/components/schemas/BaseSchedule"
1694
  - type: object
1695
  properties:
1696
  trustCancellationDate:
1697
  type: integer
1698
  description: Trust cancellation date in case of redemption. It is counted from the trade date (dayT).
1699
  example: 2
1700
  parameters:
1701
  applicationId:
1702
  name: applicationId
1703
  in: path
1704
  required: true
1705
  description: Application ID
1706
  schema:
1707
  type: string
1708
  example: '2024123100010001'
1709
  statementFixingDate:
1710
  name: statementFixingDate
1711
  in: query
1712
  required: false
1713
  description: Statement fixing date. Default is today (JST).
1714
  schema:
1715
  type: string
1716
  format: date
1717
  example: '2025-05-29'
1718
  tags:
1719
  - name: applications
1720
  description: Create/Approve creation/redemption applications
1721
  - name: information
1722
  description: Get information related to ETF creation/redemption operations