Backend Integration
Backend integration means interacting with Boros through its REST API and TypeScript SDK rather than calling contracts directly. This is the recommended path for most integrators: the API handles calldata generation, signature encoding, and on-chain submission, so you can build trading workflows without managing ABI encoding or gas mechanics yourself.
Servicesβ
All services are hosted under https://api.boros.finance.
| Service | Path prefix | Purpose |
|---|---|---|
| Open API | /open-api/v1/ or /v2/ | Market data, calldata generation, account queries, simulations |
| Send Txs Bot | /send-txs-bot/v2/ or /v3/ | Receives agent-signed calldatas, submits them on-chain, charges gas from user's gas balance |
| Stop Order | /stop-order/v1/ to /v3/ | Off-chain conditional order (take-profit/stop-loss) management |
Request Flowβ
Boros uses a two-track signing model. Sensitive account actions are signed by the root wallet and sent directly to the blockchain. Non-sensitive trading actions are signed by an agent wallet and routed through the Send Txs Bot, which manages gas, nonce, and submission.
Root wallet ββ[sensitive: deposit / withdraw / approve-agent]βββΆ Blockchain (direct)
Agent wallet ββ[non-sensitive: place / cancel / transfer]βββββββΆ Send Txs Bot βββΆ Blockchain
The Send Txs Bot charges gas from the user's on-chain gas balance in USD at the actual Arbitrum cost, with no markup.
SDKβ
The official TypeScript SDK covers signature generation, calldata encoding, and type-safe API calls for all three services.
Install
npm install @pendle/sdk-boros
Packages
| Package | Purpose |
|---|---|
@pendle/sdk-boros | Main SDK β API clients, calldata builders, signature helpers |
@pendle/boros-offchain-math | Math utilities β FixedX18 type, tick/rate conversion |
Links
- SDK repository: https://github.com/pendle-finance/sdk-boros-public
- Open API interactive docs: https://api.boros.finance/open-api/docs
- Send Txs Bot interactive docs: https://api.boros.finance/send-txs-bot/docs
- Stop Order interactive docs: https://api.boros.finance/stop-order/docs
What's in This Sectionβ
| Page | Contents |
|---|---|
| Glossary | Key terms and type definitions used throughout the API |
| Agent | Setting up and managing agent wallets |
| API | Full REST endpoint reference and integration workflows |
| WebSocket | Real-time market and account data streaming |
| Best Practices | Patterns for gas efficiency, error handling, and market management |
| Stop Orders | Conditional take-profit and stop-loss order management |