---
title: "POST /v1/portfolio/{portfolioSlug}/bank-accounts"
method: POST
path: "/v1/portfolio/{portfolioSlug}/bank-accounts"
tags: ["BankAccounts"]
---

# POST /v1/portfolio/{portfolioSlug}/bank-accounts

`POST /v1/portfolio/{portfolioSlug}/bank-accounts`

## Request

- Base URL: `https://api.tokenbooks.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tokenbooks.io/v1/portfolio/{portfolioSlug}/bank-accounts`
- Auth: API key in header `x-api-key`

## Path parameters

- `portfolioSlug` string, required

## Request body

- CreateBankAccountRequestDto
  - `currency` string, required: ISO 4217 currency code (e.g. USD, EUR, CAD); normalised to uppercase
  - `displayName` string, required: Human-readable account name
  - `institutionName` string: Name of the financial institution
  - `mask` string: Masked account number (e.g. last 4 digits)

## Response `201`

- CreateBankAccountResponseDto
  - `chainId` string, required: Chain ID — always "banking" for bank wallets
  - `walletAddress` string, required: Generated BANK wallet address
  - `bankAccountId` string, required: Internal bank account identifier
  - `currency` string, required: ISO 4217 currency code (uppercased)

---

[API](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api.md) · [All operations](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/revisions/180622e6255e?raw)