Handelsbanken Premium APIs
Sign up and start exploring our APIs
We recommend that you're always logged into our portal when using it because we have a lot of documentation that is only readable when logged in (and we think it's a better experience when you log in from the beginning!)
Onboarding
You have to go through our onboarding process to get access to the services live. Contact your local account
manager for
more details.
Find your branch
Test and verify
In order to ensure that your app is well tested before going live, it is crucial to test the integration. Currently, we do not offer a sandbox environment for our premium services but working on it.
Our APIs
The APIs listed below are the Premium APIs available as of today.
Click on the links below to read more information about the APIs
Premium FX API Market Order
POST /spot
{
"ccyPair": "EURUSD",
"amount": 1000,
"amountCcy": "EUR",
"companyId": "string",
"account": "string",
"valueDate": "2030-05-20",
"tenor": "SP",
"user": "Gordon Gekko",
"side": "string",
"clientOrderRef": "MyUniqueId-12345"
}
The Market Order API is tailored for straightforward currency conversions carried out at the prevailing market rate. Designed for simplicity, the API streamlines this process with a single request/reply. It enables clients to execute the conversion as a spot transaction or on a date of the users preference, including the option to move FX cashflows with a Swap.
Premium FX API Trade Retriever
GET /fx-trades
[{
"contraCurrency": "SEK",
"executionDate": "2025-03-06 14:16:48",
"forwardPoints": 0.0,
"legSource": "NEAR",
"orderId": "889453",
"product": "SPOT",
"rate": 10.23456,
"side": "SELL",
"spotRate": 10.2322,
"symbol": "EUR/SEK",
"tradeId": "FX.112023",
"tradingCurrency": "EUR",
"transactionAmount": 1000000.0,
"valueDate": "2025-01-17"
},{
The Trade Retriever assists clients in automating their post-trade management by enabling them to retrieve both settled and unsettled FX arrangements they hold with the bank. To use this API, users will provide a settlement span, and the API will return details about every FX arrangement the client has within the given span. Use-cases for this API includes automated bookkeeping and reconciliation.
Premium FX API Indicative Rates
GET /spot
{
"ccyPair": "EURUSD",
"amount": 1000,
"amountCcy": "EUR",
"companyId": "string",
"account": "string",
"valueDate": "2030-05-20",
"tenor": "SP",
"user": "Gordon Gekko",
"side": "string",
"clientOrderRef": "MyUniqueId-12345"
}
The Indicative Rates API is crafted to furnish clients with pre-trade price awareness capabilities. Indicative quotes mirror the FX rates available for trading through the Market Order API. A use-case might involve obtaining an indicative market rate before initiating a trade. The available products include Spot rates, Forward all-in rates, and Swap points..
Premium Accounts Information API
GET /accounts
{
"accounts": [
{
"accountId": "961311234",
"accountType": {
"availableTransactionMonths": 24,
"description": "Underkonto 365 ind",
"type": 81
},
"bban": "961311234",
"bic": "HANDSESS",
"clearingNumber": "6765",
"currency": "SEK",
"iban": "SE4060000000000961311234",
"organisationNumber": "5560143041",
"ownerName": "Braxen Nickel Snövit TEST"
}
]}
Our Account Information API provides you with our our mutual customers' account information, balances and transactions. Please visit our product information page to find out more.