Walletguide
DevelopersAPIReferencesecurityTransactions

Create security transaction

Create a security transaction with the Walletguide REST API. Parameters, response fields, and a playground you can run.

POST
/wallets/{walletId}/securityTransactions

Authorization

bearerAuth
headerAuthorization<token>

A Walletguide API key (wg_…) or an OAuth bearer token. Paste the value only. Create a key under Wallet settings → API keys.

Path Parameters

walletId*string

Row uuid

Formatuuid

Request Body

application/json
  1. body
assetId*string

Row uuid

Formatuuid
date*string
Match^\d{4}-\d{2}-\d{2}$
type*string
Value in"initialBalance""buy""sell"
quantity*number
priceValue*string

Decimal amount as a string, up to 4 fraction digits

Match^-?\d+(\.\d{1,4})?$
priceCurrency*string
feesValue*string

Decimal amount as a string, up to 4 fraction digits

Match^-?\d+(\.\d{1,4})?$
feesCurrency*string
taxValue*string

Decimal amount as a string, up to 4 fraction digits

Match^-?\d+(\.\d{1,4})?$
taxCurrency*string
categoryId*string

Category row uuid or a system-category sentinel ('transfer'/'balance'/'offset')

notes?string|null
transferCounterType?|
Value in"transaction""asset""securityTransaction""cryptoTransaction"null
transferCounterId?|

Row uuid

Formatuuid
isin*string
Length1 <= length

Response Body

The created security transaction

application/json
  1. response
id*string
Formatuuid
walletId*string
Formatuuid
firestoreId*string|null
assetId*string
Formatuuid
date*string
type*string
Value in"initialBalance""buy""sell"
isin*string
quantity*number
Range-140737488355328 <= value <= 140737488355327
priceValue*string
priceCurrency*string
Value in"EUR""AUD""BGN""BRL""CAD""CHF""CNY""CZK""DKK""GBP""HKD""HUF""IDR""ILS""INR""ISK""JPY""KRW""MXN""MYR""NOK""NZD""PHP""PLN""RON""SEK""SGD""THB""TRY""USD""ZAR"
feesValue*string
feesCurrency*string
Value in"EUR""AUD""BGN""BRL""CAD""CHF""CNY""CZK""DKK""GBP""HKD""HUF""IDR""ILS""INR""ISK""JPY""KRW""MXN""MYR""NOK""NZD""PHP""PLN""RON""SEK""SGD""THB""TRY""USD""ZAR"
taxValue*string
taxCurrency*string
Value in"EUR""AUD""BGN""BRL""CAD""CHF""CNY""CZK""DKK""GBP""HKD""HUF""IDR""ILS""INR""ISK""JPY""KRW""MXN""MYR""NOK""NZD""PHP""PLN""RON""SEK""SGD""THB""TRY""USD""ZAR"
categoryId*string
Formatuuid
notes*string|null
transferCounterType*|
Value in"transaction""asset""securityTransaction""cryptoTransaction"null
transferCounterId*|
Formatuuid
createdTime*|
Formatdate-time
createdUserId*string|null
lastUpdatedTime*|
Formatdate-time
lastUpdatedUserId*string|null
Example Request
curl -X POST 'https://api.walletguide.com/wallets/497f6eca-6276-4993-bfeb-53cbbbba6f08/securityTransactions' \  -H 'Content-Type: application/json' \  -d '{  "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",  "date": "string",  "type": "initialBalance",  "quantity": 0,  "priceValue": "string",  "priceCurrency": "string",  "feesValue": "string",  "feesCurrency": "string",  "taxValue": "string",  "taxCurrency": "string",  "categoryId": "string",  "isin": "string"}'
Example Response
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "walletId": "0ecad4a2-3549-43fb-807e-9ff033247480",  "firestoreId": "string",  "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",  "date": "string",  "type": "initialBalance",  "isin": "string",  "quantity": -140737488355328,  "priceValue": "string",  "priceCurrency": "EUR",  "feesValue": "string",  "feesCurrency": "EUR",  "taxValue": "string",  "taxCurrency": "EUR",  "categoryId": "337f5e5d-288b-40d5-be14-901cc3acacc0",  "notes": "string",  "transferCounterType": "transaction",  "transferCounterId": "bfd53a44-3603-4023-978c-daf5f740c5fd",  "createdTime": "2019-08-24T14:15:22Z",  "createdUserId": "string",  "lastUpdatedTime": "2019-08-24T14:15:22Z",  "lastUpdatedUserId": "string"}

List security transactions

List a wallet's security transactions with the Walletguide REST API. Parameters, response fields, and a playground you can run.

Retrieve security transaction

Retrieve one security transaction by id with the Walletguide REST API. Parameters, response fields, and a playground you can run.