Skip to main content

​
API Reference

Base URL: 
https://api.sweepr.co/sweepr
Authentication: 
x-api-key: <partner_api_key>

​
GET /v2/status

Returns V2 availability, supported chains, configured build mode, and V5 contract addresses.

​
POST /v2/sweep/build

Builds an EVM V2 sweep transaction. Request: 
{
  "chain": "base",
  "wallet": "0xUserWallet",
  "tokens": [
    {
      "mint": "0xTokenAddress",
      "amount": "1000000000000000000",
      "symbol": "TOKEN",
      "decimals": 18
    }
  ],
  "outputMint": "0xOutputToken",
  "slippageBps": 100
}
Response includes:
  • sweepId
  • contractVersion
  • contractAddress
  • permit2 typed data
  • transaction placeholder
  • transactionTemplate
  • feeAuthorization
  • feeMode
  • estimated output and fee summary

​
POST /v2/sweep/status/:id/confirm

Confirms a submitted V2 sweep by reading the transaction receipt and decoding SweepExecutedV5. Request: 
{
  "txHash": "0x..."
}
The endpoint updates the sweep transactions and partner fee ledger using the actual on-chain event values.

​
GET /v2/sweep/status/:id

Returns sweep status, transaction status, and fee ledger details.

​
V1 Routes

V1 remains available for Solana and off-chain partner accounting: 
GET  /v1/status
POST /v1/sweep/discover
POST /v1/sweep/build
GET  /v1/sweep/status/:id
GET  /v1/sweep/history
GET  /v1/sweep/output-tokens
Last modified on June 14, 2026