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