General Topics

The following are short articles on some general topics.

Pagination

To increase readability and optimize network traffic, some requests are returned with pagination, where 50 items are returned in a list. Use the limit query parameter to increase the number of items up to 100.

Balances

Crypto balances are always displayed as the base currency (that is, Wei) and are represented as a string data type.

Fiat balances are also displayed in the base unit of the currency. For example, 100 USD cents is equal to 1 USD.

Nonce handling

Every transaction over the Ethereum and account-based networks has a specific nonce. The first transaction sent from a particular address and vault has nonce 0, the second nonce 1, and so forth. For a given address and chain, each outgoing transaction’s nonce is unique, and must be exactly one more than the previous one (no gaps are allowed).

Note that because ERC-20 tokens are implemented as smart contracts over the EVM networks, they, too use the same nonce mechanism and the same addresses as native token transactions.

Fordefi will increment the nonce whenever a transaction is pushed to the blockchain so that the transaction that will be signed next will have the following nonce. This will prevent nonce collisions and takes the burden of handeling the nonce from the users.

API rate limits

Fordefi's API safeguards against bursts of incoming traffic to help maximize its stability for all users of the platform. Users who send many requests in quick succession might see error responses that show up as status code 429. The current number of requests per minute for each user is limited to 200.

Tip: Instead of polling, Fordefi recommends the use of webhooks to reduce calls to the Fordefi services.