Transfer Funds between Your Pockets (Same-entity)
Copy for LLM
Copy page as Markdown for LLMs
View as Markdown
Open this page as Markdown
Open in ChatGPT
Get insights from ChatGPT
Open in Claude
Get insights from Claude
Connect to Cursor
Install MCP server on Cursor
Connect to VS Code
Install MCP server on VS Code

Business Goal

Move funds in between two of your pockets, allowing to rebalance liquidity.

Note: as a result of this transfer, the current version creates T-bill Sell trades in the sending pocket and T-bill Buy trades in the receiving pocket. A future version will add an option to transfer securities between pockets without any new Sell/Buy trade.

Business Workflow Example

Customer systems:

Get from Jiko the list of pockets with their balance information.
Alternatively, get from Jiko the balance information for a specific pocket whose Jiko Id is known already by customer systems.
Determine which pockets need funding and which pockets can provide funding.
Send to Jiko a request to move funds between two pockets.
Approve the transfer request.
Monitor the execution status.
Trigger additional actions, such as third-party payment initiation based on the received balance.

Relevant API Endpoints

Step	Purpose	Jiko API Endpoints
1	Initiate a transfer, using the following parameters: • type = `ON_US` • details.type = `INTERNAL_REALLOCATION` Reminder: the transfer amount in field `amount_usdc` is represented in cents. Where value `10123` corresponds to `USD 101.23`.	POST `/api/v1/transfer-requests/`

Illustration

{
  "transfer": {
      "id": "7fe330b4-1c1c-4461-ab11-2d257e92126f",
      "type": "ON_US",
      "origin_pocket_id": "de0eb293-88ea-4e8b-97e2-505b516c4f2z",
      "amount": {
          "type": "REQUESTED_AMOUNT",
          "amount_usdc": 10123
      },
      "details": {
          "type": "INTERNAL_REALLOCATION",
          "destination_pocket_id": "844ab7f4-e94f-433b-9224-01cbe6585c00"
      },
      "description": "SEOUT 01"
  },
  "reviewers": []
}

Cancel a Same-entity Transfer request

See Cancel a JikoNet Transfer request.

Approve a Same-entity Transfer request

See Approve a JikoNet Transfer request.

Retrieve the Status of a Same-entity Transfer

See Retrieve the status of a JikoNet transfer request.