Skip to main content
A distributor is a third party that directs deposit flow into Kamino Earn vaults or Kamino Lend reserves. Deposits are attributed to a distributor by a 5-character code carried in the SPL Memo instruction of the transaction.

​
Generating codes

​
Getting credentials

Registering codes and reading their analytics require API credentials. The Kamino team issues a username and password on request. These are sent as HTTP basic auth on the calls below.

​
Registering a code

Each code is registered under a unique name of 1 to 64 characters. The name should describe the purpose of the code, as the distributor is responsible for maintaining the mapping from name to code.
The code is active immediately. A name that already exists returns 409.

​
Tagging deposits

The code is passed as the memo field of the deposit endpoints. For Kamino Earn: POST /ktx/kvault/deposit or POST /ktx/kvault/deposit-instructions:
For Kamino Lend: POST /ktx/klend/deposit or POST /ktx/klend/deposit-instructions:
When the transaction is built manually, an SPL Memo instruction whose data is the code must be included in the same transaction as the deposit instruction.
  • The memo must be exactly the code. Matching is case-insensitive.
  • Use one code per transaction.
  • The memo field accepts up to 64 UTF-8 bytes. Longer values return 400.
  • Codes use the alphabet 23456789abcdefghjkmnpqrstuvwxyz, so 0, 1, o, l and i never appear.

​
Analytics

Four endpoints report the deposits attributed to distributor codes. They are private: send the same basic auth credentials used to register codes, or the call returns 401. They cover Kamino Earn vault deposits only; tagged Kamino Lend deposits are not reported yet. Rules that apply to all four:
  • Only deposits are attributed. A withdrawal whose transaction carries a code is not listed and does not reduce any total.
  • start and end are optional query parameters, given as ISO 8601 strings or epoch milliseconds, and either can be given on its own. A missing start means the beginning of history and a missing end means now. start is inclusive and end is exclusive, and start must be before end once the missing one is filled in, so an end before 1970 or a start in the future returns 400.
  • On the three code-based endpoints the code is matched case-insensitively, and an unregistered code returns 404.
  • Responses are cached for 60 seconds.
All four endpoints page with a cursor. limit accepts 1 to 1000 and defaults to 100. When more rows remain, the response carries a paginationToken; the last page has none. Pass it back unchanged on the next call together with the same start and end. The transaction endpoints return the newest deposits first. On the wallets endpoint the token also pins the start and end the first page aggregated over, filling in an omitted bound at the moment of the first page, so later pages total the same set of deposits even while new ones arrive. A wallets token sent with a different start or end returns 400.
amount is a decimal string in the deposited token, not in vault shares. tokenSymbol is null when the token is not known to Kamino. The wallets endpoint aggregates the same deposits by wallet, ordered by wallet address. Each wallet lists one entry per token it deposited, with the total amount in that token.