Repository navigation
API Data Quality Issue - Missing Required Field in listBlockchains Response #118
Description
Hello Fireblocks Support Team,
We are experiencing a deserialization error when calling the listBlockchains API endpoint using the official Fireblocks Java SDK (version 12.1.3). The error occurs because one of the blockchain objects in the response is missing the required signingAlgo field.
API Endpoint:
Method: GET /v1/supported_assets
Documentation: https://developers.fireblocks.com/reference/list-supported-assets
SDK Method: fireblocks.blockchainsAssets().listBlockchains()
Environment:
Fireblocks SDK Version: 12.1.3 (Java)
API Base URL: https://sandbox-api.fireblocks.io/v1
Environment: Sandbox
Error Details:
❌ FAILED: Exception when calling BlockchainsAssetsApi#listBlockchains
Status code: 0
Response headers: null
Reason: null
java.util.concurrent.ExecutionException: com.fireblocks.sdk.ApiException: com.fasterxml.jackson.databind.exc.MismatchedInputException: Missing required creator property 'signingAlgo' (index 2)
at [Source: REDACTED (StreamReadFeature.INCLUDE_SOURCE_IN_LOCATION disabled); line: 1, column: 10273] (through reference chain: com.fireblocks.sdk.model.ListBlockchainsResponse["data"]->java.util.ArrayList[19]->com.fireblocks.sdk.model.BlockchainResponse["onchain"]->com.fireblocks.sdk.model.BlockchainOnchain["signingAlgo"])
at java.base/java.util.concurrent.CompletableFuture.reportGet(CompletableFuture.java:396)
at java.base/java.util.concurrent.CompletableFuture.get(CompletableFuture.java:2073)
at service.payment.gateway.fireblocks.clients.FireblocksListBlockchainsTest.main(FireblocksListBlockchainsTest.java:43)
Caused by: com.fireblocks.sdk.ApiException: com.fasterxml.jackson.databind.exc.MismatchedInputException: Missing required creator property 'signingAlgo' (index 2)
at [Source: REDACTED (StreamReadFeature.INCLUDE_SOURCE_IN_LOCATION disabled); line: 1, column: 10273] (through reference chain: com.fireblocks.sdk.model.ListBlockchainsResponse["data"]->java.util.ArrayList[19]->com.fireblocks.sdk.model.BlockchainResponse["onchain"]->com.fireblocks.sdk.model.BlockchainOnchain["signingAlgo"])
at com.fireblocks.sdk.api.BlockchainsAssetsApi.lambda$listBlockchains$5(BlockchainsAssetsApi.java:479)
at java.base/java.util.concurrent.CompletableFuture$UniCompose.tryFire(CompletableFuture.java:1150)
at java.base/java.util.concurrent.CompletableFuture$Completion.exec(CompletableFuture.java:483)
at java.base/java.util.concurrent.ForkJoinTask.doExec(ForkJoinTask.java:387)
at java.base/java.util.concurrent.ForkJoinPool$WorkQueue.topLevelExec(ForkJoinPool.java:1312)
at java.base/java.util.concurrent.ForkJoinPool.scan(ForkJoinPool.java:1843)
at java.base/java.util.concurrent.ForkJoinPool.runWorker(ForkJoinPool.java:1808)
at java.base/java.util.concurrent.ForkJoinWorkerThread.run(ForkJoinWorkerThread.java:188)
Caused by: com.fasterxml.jackson.databind.exc.MismatchedInputException: Missing required creator property 'signingAlgo' (index 2)
at [Source: REDACTED (StreamReadFeature.INCLUDE_SOURCE_IN_LOCATION disabled); line: 1, column: 10273] (through reference chain: com.fireblocks.sdk.model.ListBlockchainsResponse["data"]->java.util.ArrayList[19]->com.fireblocks.sdk.model.BlockchainResponse["onchain"]->com.fireblocks.sdk.model.BlockchainOnchain["signingAlgo"])
at com.fasterxml.jackson.databind.exc.MismatchedInputException.from(MismatchedInputException.java:59)
at com.fasterxml.jackson.databind.DeserializationContext.reportInputMismatch(DeserializationContext.java:1781)
at com.fasterxml.jackson.databind.deser.impl.PropertyValueBuffer._findMissing(PropertyValueBuffer.java:192)
at com.fasterxml.jackson.databind.deser.impl.PropertyValueBuffer.getParameters(PropertyValueBuffer.java:158)
at com.fasterxml.jackson.databind.deser.ValueInstantiator.createFromObjectWith(ValueInstantiator.java:301)
at com.fasterxml.jackson.databind.deser.impl.PropertyBasedCreator.build(PropertyBasedCreator.java:202)
at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeUsingPropertyBased(BeanDeserializer.java:526)
at com.fasterxml.jackson.databind.deser.BeanDeserializerBase.deserializeFromObjectUsingNonDefault(BeanDeserializerBase.java:1493)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserializeFromObject(BeanDeserializer.java:348)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserialize(BeanDeserializer.java:185)
at com.fasterxml.jackson.databind.deser.SettableBeanProperty.deserialize(SettableBeanProperty.java:545)
at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeWithErrorWrapping(BeanDeserializer.java:570)
at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeUsingPropertyBased(BeanDeserializer.java:440)
at com.fasterxml.jackson.databind.deser.BeanDeserializerBase.deserializeFromObjectUsingNonDefault(BeanDeserializerBase.java:1493)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserializeFromObject(BeanDeserializer.java:348)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserialize(BeanDeserializer.java:185)
at com.fasterxml.jackson.databind.deser.std.CollectionDeserializer._deserializeFromArray(CollectionDeserializer.java:359)
at com.fasterxml.jackson.databind.deser.std.CollectionDeserializer.deserialize(CollectionDeserializer.java:244)
at com.fasterxml.jackson.databind.deser.std.CollectionDeserializer.deserialize(CollectionDeserializer.java:28)
at com.fasterxml.jackson.databind.deser.SettableBeanProperty.deserialize(SettableBeanProperty.java:545)
at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeWithErrorWrapping(BeanDeserializer.java:570)
at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeUsingPropertyBased(BeanDeserializer.java:440)
at com.fasterxml.jackson.databind.deser.BeanDeserializerBase.deserializeFromObjectUsingNonDefault(BeanDeserializerBase.java:1493)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserializeFromObject(BeanDeserializer.java:348)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserialize(BeanDeserializer.java:185)
at com.fasterxml.jackson.databind.deser.DefaultDeserializationContext.readRootValue(DefaultDeserializationContext.java:342)
at com.fasterxml.jackson.databind.ObjectMapper._readMapAndClose(ObjectMapper.java:4899)
at com.fasterxml.jackson.databind.ObjectMapper.readValue(ObjectMapper.java:3846)
at com.fasterxml.jackson.databind.ObjectMapper.readValue(ObjectMapper.java:3829)
at com.fireblocks.sdk.api.BlockchainsAssetsApi.lambda$listBlockchains$5(BlockchainsAssetsApi.java:474)
... 7 more
Problem Description:
The error indicates that the blockchain object at index 19 in the response array is missing the required signingAlgo field in its onchain property. According to the SDK's model definition (BlockchainOnchain), this field is marked as required, but it's not present in the API response.
I also tested your code documented here and I have the same issue.
https://developers.fireblocks.com/reference/list-supported-assets
Please let me know if you have a solution or when you will fix it.
Best,
Thibault
Activity
github-actions commentedon Dec 3, 2025
Your issue is important to us. We will look into it shortly.
thibogue commentedon Dec 3, 2025
I also wanted to update to the last version to check if this solved the issue but on your documentation there is an issue.
There is no version.
https://developers.fireblocks.com/reference/java-sdk
LianSetter commentedon Dec 9, 2025
Thanks for reporting this with all the details.
We’ve confirmed that
signingAlgois defined as required in the OpenAPI spec but is missing in at least one/v1/supported_assetsresponse, which is causing the Java SDK deserialization error. We’re working to fix the backend response or update the schema and we’ll update here once it’s resolved.thibogue commentedon Dec 9, 2025
Thanks a lot!
Please let me know when it is fixed :)
LianSetter commentedon Dec 9, 2025
Sure:)
Also important to mention: this is a legacy endpoint.
The newer GET /v1/assets endpoint provides more detailed asset information and improved performance, so we recommend transitioning to it for better results.
thibogue commentedon Dec 9, 2025
Thanks for the info! @LianSetter
I just double checked and I'm already using /v1/assets.
In the initial description, I have written the correct failing sdk method but wrong url.
The SDK Method failing is: fireblocks.blockchainsAssets().listBlockchains()
which is using GET /v1/blockchains.
The code i'm using is