Skip to main content
This walkthrough takes you from zero access to a funded, subscribed project. Every Infra service follows the same conventions, so once these calls work you can integrate any endpoint in the reference.

​
Prerequisites

Any HTTP client. The examples use curl.

​
Get started

1

Register for an API key

Convexity Infra has no self-service signup: API keys are issued by the Convexity team. Email infra@withconvexity.com with your business details to register. You’ll receive a test key to integrate against and a live key (sk_live_...) for production traffic. See Authentication for details.
2

Exchange your API key for a token

Every endpoint (except this one) requires an OAuth 2.0 bearer token. Mint one with the client_credentials grant:
The response contains a short-lived access_token (a JWT). Send it as Authorization: Bearer <access_token> on every call, and mint a new one when it expires. See Authentication for scopes and token claims.
3

Make your first call

List the plans available to your project:
Every response uses the same envelope, { "status": true, "message": "...", "data": ... }, and every error shares one shape. See Conventions and Errors.
4

Fund your project

Subscribe to a plan (or top up your wallet balance) by minting a one-time deposit account:
The response contains one account per active settlement rail: a bank account for naira transfers and/or an on-chain wallet for stablecoins (USDC, cNGN). Pay the exact amountExpected before expiryAt; the payment settles automatically and your subscription activates. The full flow, including stablecoin deposits and upgrade proration, is covered in Fund and subscribe.
5

Build with the core services

You’re authorized and billed; now integrate the core APIs: Wallet for HD wallets and transfers, Tokenization for issuing tokenized assets, and Blockchain Events for streaming decoded on-chain events to your webhooks.
Stuck? Email infra@withconvexity.com and include the message from the error envelope and the request path.