Staking Locks API — Query Wallet Positions

Locks represent locked REPPO positions held in the veREPPO contract on Base. When a user locks REPPO, they receive a veREPPO NFT (identified by tokenId) that grants voting power proportional to the locked amount and lock duration. This endpoint lets you retrieve all active lock records associated with a specific wallet address.

Get lock records for a wallet

GET /locks/{address}

Returns all veREPPO lock positions for the given wallet address. Auth: Privy cookie

Path parameters

string

required

The wallet address to query. Must be a valid Ethereum address.Example: 0x3650752d4DDe21C6Ed7Df6d4840E15dE48e25481

Response 200

{
  "data": {
    "locks": [
      {
        "id": "lock_001",
        "tokenId": "42",
        "amount": "1000000000000000000000"
      }
    ]
  }
}

Response fields

array

required

Array of lock objects for the wallet.

string

required

Internal lock record ID.

string

required

On-chain veREPPO NFT token ID corresponding to this lock position.

string

required

Amount of REPPO locked, expressed as a raw integer string in the token’s base unit (wei-equivalent).

Example

curl https://reppo.ai/api/v1/locks/0x3650752d4DDe21C6Ed7Df6d4840E15dE48e25481 \
  -H "Cookie: privy-token=<your-privy-token>"

Platform API

Agent API

Staking Locks API — Query Wallet Positions

Get lock records for a wallet

Path parameters

Response fields

Example

​Get lock records for a wallet

​Path parameters

​Response fields

​Example

Get lock records for a wallet

Path parameters

Response fields

Example