Getting Started

Approve token management

Allow the Polygon smart contract to manage tokens by obtaining approval. Any amount can be approved, but preferably specify the exact amount ready to stake.Send a POST request to /api/v1/polygon/staking/approve. Use https://api.p2p.org for production.Example request:

curl --request POST \
     --url https://api.p2p.org/api/v1/polygon/staking/approve \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer <token>' \
     --header 'Content-Type: application/json' \
     --data '
{
  "amount": "1000000000000000000",
  "stakerAddress": "0x39D02C253dA1d9F85ddbEB3B6Dc30bc1EcBbFA17"
}'

const response = await fetch(
  "https://api.p2p.org/api/v1/polygon/staking/approve",
  {
    method: "POST",
    headers: {
      "accept": "application/json",
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      amount: "1000000000000000000",
      stakerAddress: "0x39D02C253dA1d9F85ddbEB3B6Dc30bc1EcBbFA17",
    }),
  }
);
const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://api.p2p.org/api/v1/polygon/staking/approve",
    headers={
        "accept": "application/json",
        "Authorization": "Bearer <token>",
        "Content-Type": "application/json",
    },
    json={
        "amount": "1000000000000000000",
        "stakerAddress": "0x39D02C253dA1d9F85ddbEB3B6Dc30bc1EcBbFA17",
    },
)
print(response.json())

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := map[string]interface{}{
		"amount":        "1000000000000000000",
		"stakerAddress": "0x39D02C253dA1d9F85ddbEB3B6Dc30bc1EcBbFA17",
	}
	body, _ := json.Marshal(payload)
	req, _ := http.NewRequest("POST", "https://api.p2p.org/api/v1/polygon/staking/approve", bytes.NewBuffer(body))
	req.Header.Set("accept", "application/json")
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
	respBody, _ := io.ReadAll(resp.Body)
	fmt.Println(string(respBody))
}

amount — amount of tokens in Wei (1 POL = 10¹⁸ Wei) to approve for staking.
stakerAddress — staker account address.

Example response:

{
    "result": {
      "serializeTx": "0x02f86505800214830186a094499d11e0b6eac7c0593d8fb292dcbbf815fb29ae80b844095ea7b300000000000000000000000000200ea4ee292e253e6ca07dba5edc07c8aa37a3000000000000000000000000000000000000000000000000016345785d8a0000c0",
      "to": "0x499d11E0b6eAC7c0593d8Fb292DCBbF815Fb29Ae",
      "gasLimit": "0.0000000000001",
      "data": "0x095ea7b300000000000000000000000000200ea4ee292e253e6ca07dba5edc07c8aa37a3000000000000000000000000000000000000000000000000016345785d8a0000",
      "value": "0.0",
      "chainId": 1,
      "type": 2,
      "maxFeePerGas": "0.00000000000000002",
      "maxPriorityFeePerGas": "2"
    }
  }

serializeTx — serialized unsigned transaction.
to — recipient address for this transaction.
gasLimit — maximum limit for this block.
data — transaction data.
value — amount this transaction is sending in Wei.
chainId — chain ID this transaction is authorized on, as specified by EIP-155.
type — EIP-2718 type of this transaction envelope.
maxFeePerGas — maximum price per unit of gas this transaction will pay for the combined EIP-1559 block’s base fee and this transaction’s priority fee in Wei.
maxPriorityFeePerGas — price per unit of gas in Wei, which is added to the EIP-1559 block’s base fee. This added fee is used to incentivize miners to prioritize this transaction.

To create a stake transaction, delegate tokens to P2P validator by sending a POST request to /api/v1/polygon/staking/delegate.Example request:

curl --request POST \
		 --url https://api.p2p.org/api/v1/polygon/staking/delegate \
     --head 'accept: application/json' \
     --head 'Authorization: Bearer <token>' \
     --head 'Content-Type: application/json' \
     --data '
{
  "amount": "100000000000000000",
  "stakerAddress": "0x39D02C253dA1d9F85ddbEB3B6Dc30bc1EcBbFA17"
}
'

const response = await fetch(
  "https://api.p2p.org/api/v1/polygon/staking/delegate",
  {
    method: "POST",
    headers: {
      "accept": "application/json",
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      amount: "100000000000000000",
      stakerAddress: "0x39D02C253dA1d9F85ddbEB3B6Dc30bc1EcBbFA17",
    }),
  }
);
const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://api.p2p.org/api/v1/polygon/staking/delegate",
    headers={
        "accept": "application/json",
        "Authorization": "Bearer <token>",
        "Content-Type": "application/json",
    },
    json={
        "amount": "100000000000000000",
        "stakerAddress": "0x39D02C253dA1d9F85ddbEB3B6Dc30bc1EcBbFA17",
    },
)
print(response.json())

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := map[string]interface{}{
		"amount":        "100000000000000000",
		"stakerAddress": "0x39D02C253dA1d9F85ddbEB3B6Dc30bc1EcBbFA17",
	}
	body, _ := json.Marshal(payload)
	req, _ := http.NewRequest("POST", "https://api.p2p.org/api/v1/polygon/staking/delegate", bytes.NewBuffer(body))
	req.Header.Set("accept", "application/json")
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
	respBody, _ := io.ReadAll(resp.Body)
	fmt.Println(string(respBody))
}

amount — amount of tokens in Wei (1 MATIC = 10¹⁸ Wei) to delegate.
stakerAddress — staker account address.

Example response is the same as in the approve token management step.To complete staking, sign and send the transaction to the Polygon network.

Introduction

Using AI Tools

API Products

Widget

Syncro Products

SDK Products

Deep Dive

Support

Getting Started