Positions End-points

This section provides all the needed information about how to request the data to the User DeFi Positions API
getUserDeFiHistory
get
https://merlin-api-v1.cf/api/merlin/public/userDeFiPositions/all
/{userAddress}
Get all DeFi historical information (active open positions) for a specific user
Curl
curl -X GET --header 'Accept: application/json' 
'https://merlin-api-v1.cf/api/merlin/public/userDeFiPositions/all/{userAddress}'
​
getUserDeFiHistoryWithPnl
get
https://merlin-api-v1.cf/api/merlin/public/userDeFiPositionsWithPnl/all
/userAddress
Get all DeFi historical information (both active open and past closed positions) for a specific user (including PNL)
Curl
Second Tab
curl -X GET --header 'Accept: application/json'
 'https://merlin-api-v1.cf/api/merlin/public/userDeFiPositionsWithPnl/all/{userAddress}'
​
getUserDeFiHistoryByChain
get
https://merlin-api-v1.cf/api/merlin/public/userDeFiPositions
/{userAddress}?chain={chain}
Get all DeFi historical information (active open positions) for a specific user and chain
Curl
curl -X GET --header 'Accept: application/json' 
'https://merlin-api-v1.cf/api/merlin/public/userDeFiPositions/protocol
/{userAddress}?chain={chain}&protocol={protocol}'
​
getUserDeFiHistoryByMultiChains
get
https://merlin-api-v1.cf/api/merlin/public/userDeFiPositionsByChains
/{userAddress}?chains={chain1,chain2,...,chain10}
Get all DeFi historical information (active open positions) for a specific user and chains (up to 10 chains)
Curl
curl -X GET --header 'Accept: application/json'
 -- header 'Authorization: {your api key}' 
'https://merlin-api-v1.cf/api/merlin/public/userDeFiPositionsByChains/protocol
/{userAddress}?chains={chain1,chain2,...,chain10}'
​
getUserDeFiHistoryWithPnlByChain
get
https://merlin-api-v1.cf/api/merlin/public/userDeFiPositionsWithPnl
/{userAddress}
Get all DeFi historical information (both active open and past closed positions) for a specific user and chain (including PNL)
Curl
curl -X GET --header 'Accept: application/json'
 'https://merlin-api-v1.cf/api/merlin/public/userDeFiPositionsWithPnl/{userAddress}'
getUserDeFiHistoryByProtocol
get
https://merlin-api-v1.cf/api/merlin/public/userDeFiPositions/protocol
/{userAddress}?chain={chain}&protocol={protocol}
Get all DeFi historical information (active open positions) for a specific user, chain and protocol
Curl
curl -X GET --header 'Accept: application/json' 
'https://merlin-api-v1.cf/api/merlin/public/userDeFiPositions/protocol
/{userAddress}?chain={chain}&protocol={protocol}'
​
getUserDeFiHistoryWithPnlByProtocol
get
https://merlin-api-v1.cf/api/merlin/public/userDeFiPositionsWithPnl/protocol
/{userAddress}?&protocol={protocol}
Get all DeFi historical information (both active open and past closed positions) for a specific user, chain and protocol (including PNL)
Curl
curl -X GET --header 'Accept: application/json' 
'https://merlin-api-v1.cf/api/merlin/public/userDeFiPositionsWithPnl/protocol
/{userAddress}?protocol={protocol}'
getUserDeFiPositionInfoWithPnl
get
https://merlin-api-v1.cf/api/merlin/public/userDeFiPositionsWithPnl/position
Get position information (both active open and past closed positions) only for one specific user position (identified by its position ID)
Curl
curl -X GET --header 'Accept: application/json' 
'https://merlin-api-v1.cf/api/merlin/public/userDeFiPositions/position
?position={position}'
REFERENCE - Previous
User DeFi Positions API
Positions Response Fields
Last modified 1mo ago