FAQ

Here is a list of commonly asked questions from Hatchfi customers.

What type of provider integrations does Hatchfi offer?

Hatchfi securely connects to crypto exchanges, blockchain protocols, and crypto wallets.

What type of data does Hatchfi currently pull from providers?

Hatchfi pulls detailed crypto balances, transactions, transfers, and NFT data (4 chains), including tokens from exchanges, blockchains, and wallets.

What data do you pull from CEXs?

All Hatchfi exchanges, at the minimum, support balances, trades, withdrawals, and deposits. We constantly improve our endpoints to include the full extent of the exchange API, including staking, advanced trades, and more when available.

Does Hatchfi retrieve DeFi data?

Hatchfi only pulls down the associated transactions with DeFi protocols. At this time, we do not retrieve DeFi-specific data such as staking, yield, and so on, although it is on our roadmap.

Does Hatchfi retrieve NFT data?

Hatchfi supports NFT data from four chains, including Ethereum, Arbitrum, Opitmism, and Matic. More chains will be added in the future.

Why are my transactions taking longer to show up?

There are a few reasons why transaction history might take a bit longer to process. The number of transactions within an exchange account or crypto address can go back several years. Addresses or accounts with several years of transaction history can take time to pull, parse, and make available for retrieval. Another factor at play is rate limiting with 3rd party APIs like exchanges. Exchanges provide different rate limits across their APIs, which can impact the time it takes to retrieve an end-users balance and transaction history.

In what order are balances and transactions retrieved when an end-user accesses their account via the API?

Upon a successful connection of an end-users crypto account, our API immediately pulls in the balances of the user's account. The API then queues up the retrieval of the user's transactions.

Why do some tokens not have associated fiat values for any chains that allow for 3rd party tokens, I.E., Ethereum, Solana, etc.?

Sometimes finding the correct pricing for particular coins and tokens is difficult. In crypto, developers can make any token with the same ticker symbol as another token on the same chain. We also use a 3rd party market data provider to provide

Why do some provider endpoints take longer than others?

Some providers, like exchanges, require Hatchfi to use their API to query your financial data. This often means we rely on their servers to give back the data as fast as possible. We’re working on improving our relationships and workflows to improve connection times.

Why do we see Null values in some of the returned provider data?

We make the best effort to pull the complete data set from reliable data sources across our exchanges, blockchains, and wallets. As we clean and standardize the data we retrieve, we run into instances where data might be missing or nonexistent. We provide a null value for those instances when we do not have complete data from a blockchain. For example, if a token doesn’t have a logo, it’ll be replaced by a null value instead of an empty string.

How can I request a new provider integration?

We’re always welcoming provider suggestions. If this is a blockchain or a wallet, you can suggest it here: feedback.hatchfi.co. If this is an exchange, you can also recommend it at feedback.hatchfi.co. However, we’d love to chat about helping us with test accounts or read-only keys.

I ran a /sync but where are my latest transactions?

Our /sync endpoint only fetches and updates transactions made after the most recent transaction in our database. For example, if the account hasn't been synced in the past 5 days. We will retrieve and append the latest balances and transactions from 5 days ago.

Is my users' data secure?

Yes. You can read more about our security practices here.

What is the minimum fiat value we support?

To keep the fiat value consistent across exchanges, wallets, and protocols data, the minimum value we support is 0.01.

Do we support internal transactions?

Yes, for EVM blockchains, we support internal transactions.

What is an internal transaction?

Internal transactions, despite the name (which isn't part of the yellowpaper; 
it's a convention people have settled on) aren't actual transactions, and 
aren't included directly in the blockchain; they're value transfers that 
were initiated by executing a contract.```