Endpoints

API Usage

Once you already have access to the Staking API with a validated user and existing apikeys you can start using this service.

API Reference docs

tip

You can check the Staking API Reference here:

• Rendered doc page.
• Staking OpenApi

Authentication

In order to use staking api related endpoints you need to include your API KEY

tip

Heads up! To obtain a valid API key required for authentication, please refer to the Authentication > Auth section of the documentation.

Header:

Name	Description	Example value	Required
X-API-KEY	Your api key value	<API_KEY_VALUE>	✅
X-NETWORK	Blockchain network identifier	143	⚪

X-NETWORK header

Use the X-NETWORK header to select the Monad network (currently 143 for Monad Mainnet).

info

If you omit the header the API falls back to the default Monad network configured for your account.

List available networks

Use this helper endpoint to obtain the list of Monad Magma networks that are currently enabled for your API key.

• Endpoint: /api/v1/monad/magma/networks

Response payload fields:

Field	Description
name	Internal blockchain entry name
type	Blockchain type string (always ETHEREUM)
chain_id	Chain identifier (currently 143)
is_default	true when this network is used as fallback

---

Delegate action

Craft a Magma delegate transaction:

• Endpoint: /api/v1/monad/magma/action/delegate

Description

This endpoint crafts a Magma delegate transaction ready to be signed.

Request body parameters

MagmaStakeActionDto

• address: wallet address that performs the action
• amount: MON amount to delegate (minimum 100 MON)

Returned

MonadActionResponseDto

---

Undelegate action

Craft a Magma undelegate transaction:

• Endpoint: /api/v1/monad/magma/action/undelegate

Description

This endpoint crafts a Magma undelegate transaction ready to be signed.

Request body parameters

MagmaUndelegateActionDto

• address: wallet address that performs the action
• amount: MON amount to undelegate

Returned

MonadActionResponseDto

---

Withdraw action

Craft a Magma withdraw transaction:

• Endpoint: /api/v1/monad/magma/action/withdraw

Description

This endpoint crafts a Magma withdraw transaction for a specific withdrawal request.

Request body parameters

MagmaWithdrawActionDto

• address: wallet address that performs the action
• request_id: owner request ID to withdraw

Returned

MonadActionResponseDto

---

Prepare action

Gathers signature and unsigned tx:

• Endpoint: /api/v1/monad/magma/action/prepare

Description

Prepare a signed transaction by gathering the provided signatures (r, s, v) with the unsigned transaction hex string.

Request body parameters

EthPrepareActionDto

Returned

EthPrepareActionResponseDto

---

Broadcast action

Broadcast a signed transaction:

• Endpoint: /api/v1/monad/magma/action/broadcast

Description

Broadcast a signed Magma transaction.

Request body parameters

EthBroadcastActionDto

Returned

EthBroadcastActionResponseDto

---

Balance

Get Magma staking balance for the given address:

• Endpoint: /api/v1/monad/magma/balance/{address}

Description

Get current Magma balance values for a delegator address.

Request parameters

At url param you will need to pass the address you want to retrieve balance from.

Returned

MagmaBalanceResponseDto

• staked: currently staked MON
• unstaked: pending unstaked MON
• withdrawable: withdrawable redeem request shares

---

Withdrawal info

Get Magma withdrawal requests for the given address:

• Endpoint: /api/v1/monad/magma/withdrawal/{address}

Description

Get current pending withdrawal information for a Magma address.

Request parameters

At url param you will need to pass the address you want to retrieve withdrawal info from.

Returned

MagmaWithdrawalResponseDto[]

• request_id: current owner request ID
• assets: requested assets in MON
• withdrawable_time: unix timestamp for withdraw availability

---