Rakurai (1.0.0)

Rakurai API — HTTP API for Rakurai liquid and native staking, node scheduler downloads, and validator metrics.

Unsigned transactions: Stake/unstake routes return an unsigned transaction (txn as hex). Sign with the appropriate wallet keypair, then submit with POST /api/v1/send-txn.

GET with JSON body: Some validator routes expect a JSON body on GET (as implemented). Use a client that can send a body on GET.

Download OpenAPI description

RakuraiApi.json

RakuraiApi.yaml

Servers

Production

https://api.rakurai.io/

Native

Native stake and unstake (unsigned transactions).

Operations

Stake

Request

Creates a stake account and delegates to Rakurai. Returns unsigned txn and new stake pubkey / sec_key. Optional auto-compound flag may add instructions.

Bodyapplication/jsonrequired

pubkeystringrequired

amountinteger(int64)required

Stake lamports (rent added in tx).

is_auto_compounding_enabledboolean

Default false

curl -i -X POST \
  https://api.rakurai.io/api/v1/staking/native/stake \
  -H 'Content-Type: application/json' \
  -d '{
    "pubkey": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "amount": 1000000000,
    "is_auto_compounding_enabled": false
  }'

Responses

Unsigned transaction and new stake account keys.

Bodyapplication/json

txnstringrequired

pubkeystringrequired

sec_keystringrequired

Response

application/json

{
  "txn": "010203aabbcc…",
  "pubkey": "StakeAccount111111111111111111111111111111",
  "sec_key": "deadbeef…"
}

Unstake

Request

Deactivates the listed stake accounts in one transaction; wallet must be withdraw authority.

Bodyapplication/jsonrequired

pubkeystringrequired

Withdraw authority wallet.

stake_accountsArray of stringsnon-emptyrequired

Stake account addresses (base58) to deactivate.

curl -i -X POST \
  https://api.rakurai.io/api/v1/staking/native/unstake \
  -H 'Content-Type: application/json' \
  -d '{
    "pubkey": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "stake_accounts": [
      "StakeAccount111111111111111111111111111111"
    ]
  }'

Responses

Unsigned deactivate transaction.

Bodyapplication/json

txnstringrequired

Serialized transaction message (hex) for signing.

Response

application/json

{
  "txn": "010203aabbcc…"
}

Liquid

Liquid stake, unstake, and Jupiter unstake (unsigned transactions).

Operations

Autocompound

Enable or disable auto-compounding for native stake accounts (unsigned transactions).

Operations

send_transaction

Broadcast a signed transaction on-chain.

Operations

Rakurai Scheduler

List scheduler versions and download the scheduler archive (authenticated).

Download with curl using -o to save the .tar.gz, and --fail-with-body || cat <file> so HTTP errors return JSON instead of a corrupt archive.

Operations

Validator Stats

Validators list, TVL, APY, TPS, rewards, overview.

Operations