Docs Carbium
Account and DCA API access
Sign in to the swap app, and request higher DCA API rates and a key.
Your account in the swap app at https://dex.carbium.io holds your wallets, portfolio and sign-in methods. It is also where you request higher DCA API rates and create a DCA API key.
Sign in
The account button is in the header. It reads Connect until you connect a wallet or sign in, and it opens the account menu.
If the menu shows a box for the Terms of Service, tick it. The sign-in buttons stay off until you do.
With a wallet:
- Connect your wallet.
- Open the account menu and choose "Sign in with wallet".
- Sign the message your wallet shows. You sign no transaction.
A wallet that cannot sign messages cannot sign in. The menu then shows Google and X.
With Google or X: open the account menu with no wallet connected and choose the Google or X button under "CONTINUE WITH". Each button shows only while that sign-in is available in the swap app.
To add Google or X to an account you opened with a wallet, open "Sign in methods" and choose the Google or X icon beside "Link".
The account menu
Once you are signed in, the menu lists:
| Row | What it is for |
|---|---|
| Wallets | The wallets on your account. Set one as primary or remove one. The last wallet you signed with cannot be removed. |
| Add wallet | Connect a wallet and sign once with it, or track an address without signing. Connecting a second wallet needs a sign-in method on the account first. The row shows your wallet count and limit. |
| Portfolio | What your wallets hold. Send starts here. |
| Edit profile | Your display name and avatar. The row reads "Set a display name" until you set one. |
| Sign in methods | The methods linked to your account. Link another or remove one. The swap app refuses to remove a method the account must keep. |
| DCA API access | Your DCA API keys and their rates. |
"Sign out" is at the bottom of the menu. It also disconnects your wallet.
DCA API access
The DCA API works without a key. A key counts your calls for your account in place of your IP address, and a key with a higher rate lifts some of its limits. You add, copy, replace and revoke your keys here.
Who can add a key
Your account needs Google or X as a sign-in method. Without one, the page shows "DCA API access needs Google or X." and a button to link each. Removing your last Google or X method revokes the account's keys, and the swap app says so before you confirm.
Add a key
- Open DCA API access and press Add key.
- Copy the key.
- Send it as the
x-api-keyheader on your DCA API calls.
A new key needs no approval. Its badge reads Starting, and it works within a minute, at 50 requests a second. All the free keys of one account share that rate, so more keys do not add to it.
You can copy a key again at any time. Revoke a key you no longer use: it stops working within a minute. To change a PLUS or PRO key, press Replace, then Replace to confirm or Keep to cancel: the new key keeps the rate and the limits, and the old one stops working within a minute. Revoking your only PLUS or PRO key gives them up.
Ask for a higher rate
This also needs a signed wallet: a wallet that signed for your account. A tracked address does not count. Without one, the page shows a "No wallet" badge and no Higher rate button.
- Press Higher rate on a key.
- Pick PLUS or PRO, say what the key runs and press Send.
- Keep using the key. It stays at 50 requests a second until Carbium approves, then the same key gets the new rate within a minute.
The key's badge reads Pending while the request waits, then PLUS or PRO once approved. If the request is declined, the badge reads Denied, the key keeps its 50 requests a second and you can ask again. Hover the badge to see the date.
| Free key | PLUS | PRO | |
|---|---|---|---|
| Requests a second | 50 | 100 | 400 |
| Shortest interval | 60 seconds | 30 seconds | 10 seconds |
| Running DCAs | 10 for one wallet | 30 over all your signed wallets | 100 over all your signed wallets |
| Buys in one DCA | 1,000 | 5,000 | 65,535 |
The interval, running DCAs and buys of PLUS and PRO hold for the signed wallets of your account as DCA owners, whatever key the call carries, and for no other wallet.
A higher rate raises how often you can read your DCA history. Quotes, new DCAs, sends and reads of open DCAs also run inside limits the service shares among all callers, and a key does not lift those. See Rate limits.
This key is separate from carbium.sh keys. API keys and plans: carbium.sh/docs
If you unlink Google and X, your keys stop working within a minute and your wallets go back to the Free key limits until you link one again. Carbium does not send the buys of a DCA outside those limits.