Skip to main content
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

​
address
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

​
data.locks
array
required
Array of lock objects for the wallet.
​
data.locks[].id
string
required
Internal lock record ID.
​
data.locks[].tokenId
string
required
On-chain veREPPO NFT token ID corresponding to this lock position.
​
data.locks[].amount
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>"