Calico™
v2
  • v2
  • v1
API Reference
getCalico.com
API Reference
getCalico.com
v2
  • v2
  • v1
v2
  • v2
  • v1
  1. Resources
  • Getting Started
  • Calico Connect
  • Use Cases
  • Pagination
  • Versioning
  • Platform API
    • Try it out
    • Changelog
    • Authentication
      • Authorization Callback
    • Providers
      • Add providers
      • List connected providers
      • Remove providers
    • Assets
      • User assets
      • Refresh asset list
    • Transactions
      • Transactions
      • Refresh transactions
  • Resources
    • Troubleshooting
    • Response codes
    • FAQs
  • Release Notes
    • Calico Connect 1.5 - March 2026
    • Platform API v2 - March 2026
  • Schemas
    • Schemas
      • CalicoErrorResponse
      • RefreshResponse
    • AddProvidersRequest
    • AddProvidersResponse
    • AddProvidersData
    • ListProvidersResponse
    • ListProvidersData
    • ProviderMetadata
    • DeleteProvidersRequest
    • DeleteProvidersResponse
    • DeleteProvidersData
    • ProviderMetadataV2.1
    • ConnectedProvidersMetadataV2.1
    • GetAssetsResponse
    • GetAssetsData
    • AssetPosition
    • GetTransactionsResponse
    • GetTransactionsData
    • TransactionCategorization
    • TransactionType
    • FeeItem
    • FeeObject
    • CurrencyValue
    • Transactions data
    • Input only transactions
    • Send transaction data
    • Receive transaction data
    • Output only transaction data
    • Transactions with input and output
    • Uncategorized transaction data
    • CryptoSourceCredentialAuthType
    • RefreshResponseData
    • IntegrationResponse
    • IntegrationData
    • AuthMetaData
    • PageData
    • APIConnection
    • WalletConnection
    • OAuth2Connection
    • ErrorItem
    • ProviderId
    • GetConsentURLForThirdPartyResponse
  1. Resources

Troubleshooting

Having trouble linking your crypto account? This site walks you through common connection issues, supported platforms, and step-by-step solutions to get you back on track.
Calico Connect onboarding
Having trouble with Calico Connect?
Try these troubleshooting tips.
API Keys
Having trouble creating or copying API Keys to connect to Calico?
See these suggestions.

Calico Connect#

Having trouble with Calico Connect?
Try these troubleshooting tips.

Fidelity Crypto account#

Issue Summary#

When users attempt to connect their Fidelity Crypto account through the Calico onboarding flow, the default authentication flow may fail due to issues with Fidelity’s app-based OTP verification.

What’s Happening#

The user clicks “Add Fidelity Crypto Account” in the Calico onboarding flow to initiate the OAuth flow.
Fidelity prompts the user to approve the connection via a push notification in the Fidelity app.
The user attempts to verify using the OTP from the Fidelity app, but the OTP does not work as expected, preventing successful connection.

Recommended Solution#

Request to use SMS-based OTP instead of app-based OTP. This alternative method has proven more reliable for completing the authentication and establishing the account connection.

How to Do This#

When prompted by Fidelity, look for an option to “Send code via SMS” or “Use another method”.

Coinbase OAuth onboarding#

Issue summary#

When onboarding Coinbase through the Calico onboarding flow, some users encounter a verification failure during the final step of Coinbase’s multi-factor authentication process. This typically happens when:
1.
The user selects Coinbase in the Calico widget UI to begin OAuth onboarding.
2.
They are prompted to use passkeys, which they skip.
3.
They choose to authenticate via an authenticator app and enter a valid OTP.
4.
Coinbase then sends a verification email to the user’s personal email address.
5.
The user attempts to approve the verification link from a non-work device (e.g., mobile phone or personal laptop).

Why This Happens#

Coinbase uses the following factors for additional verification:
Location
Browser
Device
If these three factors do not align with the original OAuth session (e.g., the user clicks the email link on a different device or network), Coinbase blocks the verification attempt.

Solution#

To successfully complete the onboarding:
Forward the Coinbase verification email to your work email address.
Open the verification link from the same device, browser, and network where you initiated the OAuth flow via Calico.

Coinbase verification link#

Issue summary#

When following the instructions to connect Coinbase in Calico Connect, users may have issues linking the account during the verification step. Please note the following issues:
1.
The verification link must be completed within 30 seconds or it will expire.
2.
The link must be opened on the same device (i.e., the work computer) where the connection was initiated. Opening it on another device causes the process to fail.

API key#

Issue summary#

Users may have trouble creating an API key.
For more information on creating a key, use the appropriate help pages:

Coinbase API Key#

https://help.coinbase.com/en/exchange/managing-my-account/how-to-create-an-api-key

Binance API Key#

https://support.binance.us/hc/en-us/articles/360051091473-How-To-Create-an-API-Key-on-Binance-US

Gemini API Key#

https://support.gemini.com/hc/en-us/articles/360031080191-How-do-I-create-an-API-key

Kraken API Key#

https://support.kraken.com/articles/360022839451-how-to-create-an-api-key-for-kraken-derivatives

Copying the API key#

Issue summary#

After creating an API key, users may have trouble with the format of the key and copying it for use when connecting a crypto source in the Calico Connect widget.

Recommended Solution#

For Coinbase, a user may receive an API key name and Private key on a screen with copy icons. Use the copy icons to copy the entire returned string as is and paste into the Calico Connect widget.

API key name#

Copy the entire content of the box. Use this as the API Key in the Calico Connect widget.
Example#
organizations/6a8bfa4e-daf7-4227-a441-fa460886f76c/apiKeys/0f1b7317-7bf8-45fa-9552-3b62d92c3b7a

Private key#

Copy the entire content of the box, including text which includes "Begin" and "end". Use this as the API Secret in the Calico Connect widget.
Example#
-----BEGIN EC PRIVATE KEY-----\nZ26kiOEiYr7MixyazYdSGlwFLMC8O+fipqtzjCfHpeINEBVKfNSkC7gHr2Qk8GsL\nESjwmEJKArSAxRhsLlVlzKfDzlUvQw+1jDPAMoMfQvpUGHzlScuStUXt0MReJ0Zi\nEdAKBfxPQ7xJ9uGepeLAoG347GNle4rikA==\n-----END EC PRIVATE KEY-----\n
Previous
Resources
Next
Response codes