Inkwell Finance Documentation

GET

api

ika

agent

metadata

Network metadata

curl --request GET \
  --url https://backend.inkwell.finance/api/v1/ika/agent/metadata \
  --header 'X-API-Key: <api-key>'

{
  "network": "mainnet",
  "minStakeAmount": "1000000000",
  "decimals": 9,
  "coinType": "<string>",
  "stakedIkaType": "<string>",
  "systemObjectId": "<string>",
  "epochDurationMs": 86400000,
  "minValidatorJoiningStake": "<string>"
}

Authorizations

X-API-Key

string

header

required

Agent API key obtained via self-registration or admin registration

Response

200 - application/json

Network metadata

network

string

Example:

"mainnet"

minStakeAmount

string

Minimum stake in MIST (1 IKA = 1e9 MIST)

Example:

"1000000000"

decimals

integer

Example:

9

coinType

string

stakedIkaType

string

systemObjectId

string

epochDurationMs

integer

Example:

86400000

minValidatorJoiningStake

string

Scored validatorsReturns validators scored by APY, uptime, and commission. Results are filtered by your agent tier: - **free**: top 10 validators - **builder**: top 25 - **pro**: all validators Pass `validators` query param to filter to specific validator IDs (bypasses tier filter).

Network metadata

curl --request GET \
  --url https://backend.inkwell.finance/api/v1/ika/agent/metadata \
  --header 'X-API-Key: <api-key>'

{
  "network": "mainnet",
  "minStakeAmount": "1000000000",
  "decimals": 9,
  "coinType": "<string>",
  "stakedIkaType": "<string>",
  "systemObjectId": "<string>",
  "epochDurationMs": 86400000,
  "minValidatorJoiningStake": "<string>"
}