Cloak API
Becoming a partner
Create your Cloak account in the Veilo Partner Portal, complete your profile, and configure credentials and fee wallets from the dashboard. New integrations remain pending until Veilo enables API access.
Create your account
Start at partners.veilo.network. Account, credential, fee-wallet, and activity settings are managed there.
| Item | Why |
|---|---|
| Work email and password | Secures your portal account. |
| Name or alias | Identifies your account in the portal and reports. |
| Fee wallet | A Solana address that may receive your revenue share. Add one from the Fees page before sending an order with feeBps > 0. |
What the portal provides
- API-key management. Create multiple labelled credentials and rotate or revoke them from the dashboard. Complete keys are shown only at creation or rotation.
- Partner-scoped activity. Review order volume, settlement performance, transaction status, and quoted, earned, or outstanding partner fees.
- Fee-wallet controls. Register and remove eligible Solana destinations without sharing a private key.
Default capacity
| Limit | Portal default | Notes |
|---|---|---|
| feeBps | 50 bps · 0.50% | Hard ceiling on your revenue share. |
| Maximum order | Full service ceiling | The exact configured USD ceiling is shown in your dashboard. |
| Minimum order | Per asset | Read the current raw bounds from List tokens and each quote response. |
| Rolling 24h volume cap | Unlimited | No rolling cap by default. |
| Read requests | 600 / min | Quotes, status, tokens. Keyed to your account, not your IP. |
| Order creation | 60 / min | Budgeted separately, so aggressive polling never starves order creation. |
| Fee-wallet availability | Shown in the Fees page | The portal displays the exact time each wallet becomes eligible for partner fees. |
Manage fee wallets from the Fees page
Only a wallet registered to your partner account can receive partner fees. Adding or removing a destination requires a signed-in portal session and recent password confirmation. The portal shows whether each wallet is pending or eligible.
An API key may nominate an eligible wallet on an order, but it cannot register or remove wallet addresses. Never enter a private key or seed phrase in the portal.
Going live
Each API key is bound to the environment shown in the portal. Use it only with the matching API deployment.
You may prepare credentials while your integration is pending, but they return 401 UNAUTHORIZED until Veilo enables the partner. The dashboard displays the current activation status.
Before your first order
- Confirm your wallet layer signs v0 transactions.
- If you collect partner fees, register every destination you intend to use and wait until the Fees page marks it eligible.
- Handle the error codes that carry bounds. They let you render a real limit instead of a generic failure.
- Send an idempotency key on every order creation.