Performance

Calculate PnL performance metrics between two dates for wallets, positions, assets, or holdings.

Calculate PnL Performance

get

Calculate performance metrics (PnL, ROI, TWR, APR, APY) between two dates for various entity types. This endpoint reconstructs PnL over custom date ranges by comparing snapshots at start and end dates, leveraging DTD (Day-To-Day) metrics to measure real PnL from date A to date B.

Supported Query Types:

  • wallet_address - Full wallet performance with breakdowns by protocol, position, asset, and holding

  • protocol_name + wallet_address - Protocol-specific performance within a wallet with breakdowns by position and asset

  • asset_address + wallet_address - Token-specific performance across all positions and holdings with breakdowns by asset instances and holdings

  • position_id - Position performance with breakdown by assets within the position

  • asset_id - Individual asset performance (no breakdowns)

  • holding_id - Individual holding performance (no breakdowns)

Each response includes total metrics plus detailed breakdowns depending on the entity type.

Authorizations
x-api-KeystringRequired

API key for authentication

Query parameters
wallet_addressstringOptional

Wallet address to calculate performance for. Can be used alone or combined with protocol_name or asset_address.

Example: 0x1234567890abcdef1234567890abcdef12345678Pattern: ^0x[a-fA-F0-9]{40}$
protocol_namestringOptional

Protocol name (requires wallet_address) to calculate performance for a specific protocol within a wallet

Example: aave
asset_addressstringOptional

Asset token address (requires wallet_address) to calculate performance for a specific token across all positions and holdings

Example: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48Pattern: ^0x[a-fA-F0-9]{40}$
position_idstringOptional

Position ID to calculate performance for (mutually exclusive with other entity query types)

Example: ethereum-aave-1640995200000-0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2-0x1234567890abcdef1234567890abcdef12345678
asset_idstringOptional

Asset ID to calculate performance for (mutually exclusive with other entity query types)

Example: ethereum-aave-collateral-USDC-0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48-0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2-0x1234567890abcdef1234567890abcdef12345678
holding_idstringOptional

Holding ID to calculate performance for (mutually exclusive with other entity query types)

Example: ethereum-ETH-0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2-0x1234567890abcdef1234567890abcdef12345678
from_datestringRequired

Start date for performance calculation. Accepts simple format (2025-11-03) or full ISO 8601 (2025-11-03T00:00:00Z)

Example: 2025-11-03
to_datestringRequired

End date for performance calculation. Accepts simple format (2025-11-03) or full ISO 8601 (2025-11-03T23:59:59Z)

Example: 2025-11-03
Responses
200

Successful response with performance metrics

application/json
get
/performance
PreviousPositionsNextModels

Last updated