The Money + Positions API from Lemon Markets — 9 operation(s) for money + positions.
openapi: 3.1.0
info:
title: "lemon.markets Brokerage API \uD83C\uDF4B Accounts: General Money + Positions API"
version: 0.1.0
servers:
- url: https://sandbox.api.lemon.markets/v1
description: Sandbox
security:
- bearerAuth: []
tags:
- name: Money + Positions
paths:
/accounts/{account_id}/financials:
get:
summary: Get Financials
operationId: get_financials_accounts__account_id__financials_get
tags:
- Money + Positions
parameters:
- name: account_id
required: true
schema:
title: Account Identifier
type: string
in: path
example: cusa_20323d55bb264d42b0b225d293591049
description: 'An account identifier.
'
- required: true
schema:
title: Lmg-Data-Privacy-Access-Principal
type: string
name: LMG-Data-Privacy-Access-Principal
in: header
- required: true
schema:
title: Lmg-Data-Privacy-Access-Justification
type: string
name: LMG-Data-Privacy-Access-Justification
in: header
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CustomerAccountFinancialsResponse'
example:
balance: '1000.00'
blocked: '100.00'
buying_power: '950.00'
currency: EUR
funds_to_withdraw: '900.00'
to_be_settled: '50.00'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Unprocessable Entity
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
5XX:
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
/accounts/{account_id}/positions:
get:
tags:
- Money + Positions
summary: Get Positions
operationId: get_positions
parameters:
- name: account_id
required: true
schema:
title: Account Identifier
type: string
in: path
example: cusa_20323d55bb264d42b0b225d293591049
description: 'An account identifier.
'
- name: cursor
required: false
schema:
title: Cursor
type: string
description: 'A pagination cursor. When you receive a paginated response containing the property `pagination.next_cursor`, you can pass its value here to get the next page of results for your query.
A cursor will include filter parameters, so there is not need to specify both the `cursor` and any other filter parameter.
'
in: query
- name: limit
description: 'In order to customize the number of elements returned, you can provide a limit here. The service will not return more elements than specified.
'
required: false
schema:
title: Limit
maximum: 100
minimum: 1
type: integer
default: 100
in: query
- name: securities_account
in: query
required: false
schema:
type: string
title: Securities Account
description: 'A securities account identifier. Use this parameter to limit results to positions for a specific securities account only.
'
- name: LMG-Data-Privacy-Access-Principal
required: true
schema:
title: Lmg-Data-Privacy-Access-Principal
type: string
in: header
- name: LMG-Data-Privacy-Access-Justification
required: true
schema:
title: Lmg-Data-Privacy-Access-Justification
type: string
in: header
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/EncodedPaginatedCollectionResponse_PositionsResponse_'
example:
data:
- buy_in: '139.7589'
currency: EUR
instrument:
isin: DE0005933931
title: iShares Core DAX UCITS ETF DE
latest_bid: '151.9200'
latest_price:
amount: '151.9200'
type: quote
updated_at: '2026-04-23T10:30:00+00:00'
quantity: '7.95219'
- buy_in: '224.2147'
currency: EUR
instrument:
isin: IE00B0M62X26
title: iShs EO Inf.Li.Gov.Bd U.ETF(D)
latest_bid: '225.1401'
latest_price:
amount: '225.1401'
type: quote
updated_at: '2026-04-23T10:30:00+00:00'
quantity: '0.89200'
- buy_in: '74.0859'
currency: EUR
instrument:
isin: IE00B441G979
title: iShsV-MSCI W.EUR Hgd U.ETF Acc
latest_bid: '87.3500'
latest_price:
amount: '87.3500'
type: quote
updated_at: '2026-04-23T10:30:00+00:00'
quantity: '681.82608'
- buy_in: '1.0000'
currency: EUR
instrument:
isin: IE0008643037
title: DWS Dt.Gl.Liq.-Man. Euro
latest_price:
amount: '1.0000'
type: nav
valuation_date: '2026-04-23'
quantity: '280.67394'
pagination:
next_cursor: null
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Unprocessable Entity
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
5XX:
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
/accounts/{account_id}/sweeps:
get:
summary: List Balance Sweeps
tags:
- Money + Positions
operationId: list_sweeps
parameters:
- name: account_id
in: path
required: true
schema:
type: string
title: Account ID
- name: cursor
in: query
required: false
schema:
type: string
title: Cursor
- name: limit
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 1
default: 100
title: Limit
- name: LMG-Data-Privacy-Access-Principal
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Principal
- name: LMG-Data-Privacy-Access-Justification
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Justification
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Page_SweepResponse_'
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unauthorized
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Not Found
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unprocessable Entity
5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Server Error
/accounts/{account_id}/sweeps/{sweep_id}:
get:
summary: Get Balance Sweep
tags:
- Money + Positions
operationId: get_sweep
parameters:
- name: sweep_id
in: path
required: true
schema:
type: string
title: Sweep Id
- name: account_id
in: path
required: true
schema:
type: string
title: Account ID
- name: LMG-Data-Privacy-Access-Principal
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Principal
- name: LMG-Data-Privacy-Access-Justification
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Justification
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/SweepResponse'
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unauthorized
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Not Found
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unprocessable Entity
5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Server Error
/accounts/{account_id}/transactions:
get:
tags:
- Money + Positions
summary: Get Transactions
operationId: get_transactions
parameters:
- name: account_id
required: true
schema:
title: Account Identifier
type: string
in: path
example: cusa_20323d55bb264d42b0b225d293591049
description: 'An account identifier.
'
- name: cursor
required: false
schema:
title: Cursor
type: string
description: 'A pagination cursor. When you receive a paginated response containing the property `pagination.next_cursor`, you can pass its value here to get the next page of results for your query.
A cursor will include filter parameters, so there is not need to specify both the `cursor` and any other filter parameter.
'
in: query
- name: limit
description: 'In order to customize the number of elements returned, you can provide a limit here. The service will not return more elements than specified.
'
required: false
schema:
title: Limit
maximum: 100
minimum: 1
type: integer
default: 100
in: query
- required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Principal
name: LMG-Data-Privacy-Access-Principal
in: header
- required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Justification
name: LMG-Data-Privacy-Access-Justification
in: header
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Page_Transaction_'
example:
data:
- components:
- amount: '1000.00'
currency: EUR
direction: credit
type: cash
history:
- status: created
timestamp: '2023-08-14T12:47:43.891794+00:00'
id: txn_e74d790e92ee4cc0935bc65c9fe20c68
source: de_5ed37b6e25ca466b86e3ced62f78fbbe
status: created
type: deposit
pagination:
next_cursor: null
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'422':
description: Unprocessable Entity
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
5XX:
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
/accounts/{account_id}/transactions/{transaction_id}:
get:
summary: Get Transaction
operationId: get_transaction_by_id
tags:
- Money + Positions
parameters:
- name: account_id
required: true
schema:
title: Account Identifier
type: string
in: path
example: cusa_20323d55bb264d42b0b225d293591049
description: 'An account identifier.
'
- name: transaction_id
in: path
required: true
schema:
type: string
title: Transaction Identifier
description: 'The identifier of the transaction to be fetched.
'
- name: LMG-Data-Privacy-Access-Principal
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Principal
- name: LMG-Data-Privacy-Access-Justification
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Justification
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/Transaction'
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unauthorized
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Not Found
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unprocessable Entity
5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Server Error
/accounts/{account_id}/withdrawals:
get:
summary: List Withdrawals
tags:
- Money + Positions
operationId: list_withdrawals
parameters:
- name: account_id
required: true
schema:
title: Account Identifier
type: string
in: path
example: cusa_20323d55bb264d42b0b225d293591049
description: 'An account identifier.
'
- name: cursor
required: false
schema:
title: Cursor
type: string
description: 'A pagination cursor. When you receive a paginated response containing the property `pagination.next_cursor`, you can pass its value here to get the next page of results for your query.
A cursor will include filter parameters, so there is not need to specify both the `cursor` and any other filter parameter.
'
in: query
- name: limit
description: 'In order to customize the number of elements returned, you can provide a limit here. The service will not return more elements than specified.
'
required: false
schema:
title: Limit
maximum: 100
minimum: 1
type: integer
default: 100
in: query
- name: LMG-Data-Privacy-Access-Principal
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Principal
- name: LMG-Data-Privacy-Access-Justification
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Justification
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/EncodedPaginatedCollectionResponse_WithdrawalResponse_'
example:
data:
- amount: '12.34'
created_at: '2023-08-31T16:41:01.825087+00:00'
currency: EUR
history:
- status: confirmed
timestamp: '2023-08-31T16:41:30.636649+00:00'
- status: created
timestamp: '2023-08-31T16:41:01.825087+00:00'
id: wtd_50d0271f9fd143adb4d6e3af8962ed4d
receiving_account:
bic: COBADEFFXXX
iban: DE89370400440532013000
sca:
challenge: idpMw_UsyU31awFi81Atyw==
required: true
status: confirmed
pagination:
next_cursor: null
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unauthorized
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Not Found
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unprocessable Entity
5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Server Error
post:
summary: Create Withdrawal
tags:
- Money + Positions
operationId: create_withdrawal
parameters:
- name: account_id
required: true
schema:
title: Account Identifier
type: string
in: path
example: cusa_20323d55bb264d42b0b225d293591049
description: 'An account identifier.
'
- name: LMG-Data-Privacy-Access-Principal
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Principal
- name: LMG-Data-Privacy-Access-Justification
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Justification
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateWithdrawalRequest'
example:
amount: '12.34'
responses:
'201':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WithdrawalResponse'
example:
amount: '12.34'
created_at: '2023-08-31T16:41:01.825087+00:00'
currency: EUR
history:
- status: created
timestamp: '2023-08-31T16:41:01.825087+00:00'
id: wtd_50d0271f9fd143adb4d6e3af8962ed4d
receiving_account:
bic: COBADEFFXXX
iban: DE89370400440532013000
sca:
challenge: idpMw_UsyU31awFi81Atyw==
required: false
status: created
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unauthorized
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Not Found
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unprocessable Entity
5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Server Error
/accounts/{account_id}/withdrawals/{withdrawal_id}:
get:
summary: Get Withdrawal
tags:
- Money + Positions
operationId: get_withdrawal
parameters:
- name: account_id
required: true
schema:
title: Account Identifier
type: string
in: path
example: cusa_20323d55bb264d42b0b225d293591049
description: 'An account identifier.
'
- name: withdrawal_id
in: path
required: true
schema:
type: string
title: Withdrawal Identifier
description: 'A withdrawal identifier.
'
- name: LMG-Data-Privacy-Access-Principal
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Principal
- name: LMG-Data-Privacy-Access-Justification
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Justification
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WithdrawalResponse'
example:
amount: '12.34'
created_at: '2023-08-31T16:41:01.825087+00:00'
currency: EUR
history:
- status: confirmed
timestamp: '2023-08-31T16:41:30.636649+00:00'
- status: created
timestamp: '2023-08-31T16:41:01.825087+00:00'
id: wtd_50d0271f9fd143adb4d6e3af8962ed4d
receiving_account:
bic: COBADEFFXXX
iban: DE89370400440532013000
sca:
challenge: idpMw_UsyU31awFi81Atyw==
required: false
status: confirmed
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unauthorized
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Not Found
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unprocessable Entity
5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Server Error
/accounts/{account_id}/withdrawals/{withdrawal_id}/confirm:
post:
summary: Confirm Withdrawal
tags:
- Money + Positions
operationId: confirm_withdrawal
parameters:
- name: account_id
required: true
schema:
title: Account Identifier
type: string
in: path
example: cusa_20323d55bb264d42b0b225d293591049
description: 'An account identifier.
'
- name: withdrawal_id
in: path
required: true
schema:
type: string
title: Withdrawal Identifier
description: 'A withdrawal identifier.
'
- name: LMG-Data-Privacy-Access-Principal
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Principal
- name: LMG-Data-Privacy-Access-Justification
in: header
required: true
schema:
type: string
title: Lmg-Data-Privacy-Access-Justification
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ConfirmWithdrawalRequest'
example: {}
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/WithdrawalResponse'
example:
amount: '12.34'
created_at: '2023-08-31T16:41:01.825087+00:00'
currency: EUR
history:
- status: confirmed
timestamp: '2023-08-31T16:41:30.636649+00:00'
- status: created
timestamp: '2023-08-31T16:41:01.825087+00:00'
id: wtd_50d0271f9fd143adb4d6e3af8962ed4d
receiving_account:
bic: COBADEFFXXX
iban: DE89370400440532013000
sca:
challenge: idpMw_UsyU31awFi81Atyw==
required: false
status: confirmed
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Bad Request
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unauthorized
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Not Found
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Unprocessable Entity
5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
description: Server Error
components:
schemas:
TransactionComponent:
title: Transaction Component
description: 'A component of a transaction. It indicates changes to the positions or funds affected by a transaction.
'
anyOf:
- $ref: '#/components/schemas/CashComponent'
- $ref: '#/components/schemas/SecuritiesComponent'
discriminator:
propertyName: type
mapping:
cash: '#/components/schemas/CashComponent'
securities: '#/components/schemas/SecuritiesComponent'
StatusChange_TransactionStatus_:
title: StatusChange of TransactionStatus
properties:
status:
$ref: '#/components/schemas/TransactionStatus'
timestamp:
type: string
format: date-time
title: Timestamp
description: 'The timestamp of the event. It represents the point in time at which the transaction was updated.
'
example: '2023-06-23T07:29:55.465000+00:00'
type: object
required:
- status
- timestamp
EncodedPaginationResponse:
type: object
title: EncodedPaginationResponse
properties:
next_cursor:
type: string
title: Next Cursor
description: 'When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.
'
description: 'Information about accessing elements beyond the ones that were returned.
'
example:
next_cursor: <opaque-data>
Page_Transaction_:
title: Page of Transaction
properties:
data:
title: Data
description: 'The elements of the response.
'
items:
$ref: '#/components/schemas/Transaction'
type: array
pagination:
$ref: '#/components/schemas/Pagination'
type: object
required:
- data
- pagination
ErrorResponse:
title: ErrorResponse
required:
- message
type: object
properties:
message:
title: Message
type: string
SweepResponse:
properties:
id:
type: string
title: Identifier
description: 'A unique value identifying this sweep.
'
status:
$ref: '#/components/schemas/SweepStatus'
amount:
type: string
title: Amount
description: 'The amount of money to be withdrawn during the balance sweep.
'
currency:
type: string
maxLength: 3
minLength: 3
title: Currency
description: 'An ISO 4217 three-letter currency code. Its value represents the currency for the amount listed here. The only currently available currency is `"EUR"`.
'
history:
items:
$ref: '#/components/schemas/StatusChange_SweepStatus_'
type: array
title: History
type: object
required:
- id
- status
- amount
- currency
- history
title: SweepResponse
StatusChange_SweepStatus_:
properties:
status:
$ref: '#/components/schemas/SweepStatus'
timestamp:
type: string
format: date-time
title: Timestamp
description: 'The timestamp of the event. It represents the point in time at which the sweep was updated.
'
example: '2023-06-23T07:29:55.465000+00:00'
type: object
required:
- status
- ti
# --- truncated at 32 KB (51 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lemon-markets/refs/heads/main/openapi/lemon-markets-money-positions-api-openapi.yml