Welcome to the Knova API Reference page.

This is your home for accessing everything you need to integrate unified asset infrastructure into your applications.

Our REST APIs give you secure, scalable, and real-time access to the full functionality of our platform—so you can build, integrate, and innovate without limits. Whether you’re creating new applications, automating workflows, or embedding our services into your own products, this portal is your starting point.

Explore the docs, and let us know how we can help you bring your ideas to life.

See here for the OpenAPI specification. Let's get started!

Start with creating a user. You can specific your user IDs against this and alias/usernames and this will create a sub-wallet within Knova linked to this user.

curl -X POST "https://api.knova.finance/users" \
-H "Content-Type: application/json" \
-d '{
  "id": "user_id",
  "username": "example-user"
  }'

Create an asset address- Example USDC_ETH. You'll now have a USDC_ETH address for your user.

curl -X POST "https://api.knova.finance/users/$USER_ID/addresses" \
-H "Content-Type: application/json" \
-d '{
  "asset_code":"USDC_ETH",
  "vendor": "wallet_provider1"
  }'

Use a faucet service such as https://faucet.circle.com/ to send USDC_ETH to that address.
Send USDC_ETH to a desired recipient address. This will transfer the Digital Twin as well as the USDC on-chain.

curl -X POST "https://api.knova.finance/users/$USER_ID/transactions/onchain/transfer" \
-H "Content-Type: application/json" \
-d '{
  "to": {
    "address": "0xF7a28c83042753141Eb906A9C74079f347C82213"
  },
  "fee": {
    "level": "LOW",
    "fee_type": "non_base"
  },
  "external_id": "trxId1234",
  "asset_code": "USDC_ETH",
  "amount": "100"
  }'

Send USDC_ETH to a desired recipient address within Knova. This will transfer only the Digital Twin off-chain, fast and free of gas fees.

curl -X POST "https://api.knova.finance/users/$USER_ID/transactions/internal/transfer" \
-H "Content-Type: application/json" \
-d '{
	"external_id": "trxId1235",
  "asset_code": "USDC_ETH",
  "recipient_id": "$USER_ID2",
  "amount": "100",
  "memo": "transfer within the same institution"
  }

Hope that helps with some basics! Now you are able to:

Create users
Create addresses
Receive assets to that address
Send assets on-chain
Send assets off-chain, digital twin only.

Happy Coding!