Addepar

Addepar is a wealth management platform integration that syncs household and investment account data with complex entity hierarchies.

Overview

Attribute	Value
Integration Type	Data Import (Read-only)
Authentication	OAuth 2.0
Data Flow	Addepar → RightCapital (inbound only)
Data Sync	Nightly automatic
Developer	Winston Li (Zefeng Li)
Cron Owner	heli.yin

Account Hierarchies

Addepar has complex entity hierarchy with optional Household feature:

With Household Feature:
  Household → Client(s) → Holding Account(s) → Securities

Without Household Feature:
  Client (top-level) → Holding Account(s) → Securities

Addepar Entity	RightCapital Mapping
Household	Household
Client	Household
Holding Account	Investment Account

Authentication

• Standard OAuth 2.0 authorization code flow
• Requires Addepar-Firm header for all API requests
• Refresh token handled automatically

Portfolio Query API

Async job-based workflow:

1. POST /v1/jobs - Create portfolio query
2. GET /v1/jobs/{id} - Poll for completion
3. GET /v1/jobs/{id}/download - Get results

Caching

Household data cached daily to avoid repeated API calls.

Entity Mapping

Addepar Type	RightCapital Type
Stock	Equity
Bond	Bond
ETF	ETF
Mutual Fund	Open End Fund
Option	Option

Code Locations

Component	Path
Connector	retail-api/app/Integrations/Addepar/Connector.php
Integrator	retail-api/app/Integrations/Addepar/Integrator.php
OAuth Provider	retail-api/app/Integrations/Addepar/OAuth2/Provider.php
Models	retail-api/app/Integrations/Addepar/Models/

Common Issues

Rate Limiting (HTTP 429)

Solution: Integration respects X-RateLimit-Retry-After header

Job Timeout

Symptom: “Job still has not been completed”

Solution: Exponential backoff (5s → 320s) for console jobs

Invalid Refresh Token

Solution: Re-authenticate by clicking “Connect” again

Related

• Orion - Similar portfolio management integration