Portfolio

These endpoints are related to the current contents of a wallet.

Purchasing

Access can be purchased through our API Dashboard website. See the Purchasing page for more info.

Authentication

Access to the API requires a valid API key which can be generated after purchasing a plan on our website

General Information

The information provided is as of last confirmed slot when not stale.

Gets portfolio positions for a specified wallet

get

Gets portfolio positions for a specified wallet, including summary with total values and staleness statuses

Authorizations

Path parameters

addressstringrequired

Wallet address to fetch data for

Query parameters

maxWaitTimenumberoptional

Max wait time in seconds. The response will wait for all fetchers to complete, or till the max wait time is reached before returning data. Default is 0.

staleTimenumberoptional

Stale time in seconds. Amount of time data is considered fresh after being fetched. Once time has elapsed, data will be marked as stale. Default is 60 seconds. Minimum allowed value is 15 seconds.

showSmallBalancesbooleanoptional

Show balances worth less than $0.99 USD equivalent in the response. Default is true.

showcNFTsbooleanoptional

Show compressed NFTs in the response. Doesn't affect nft module credit cost. Option is provided for spam reduction. Default is true.

modulesstringoptional

All modules included by default. If specified, only the provided modules will be returned and charged credits for. Full list with credit costs here.

excludeModulesstringoptional

All modules included by default. If specified, provided modules will be excluded and only included modules will be charged credits for. Full list with credit costs here

apiKeystringoptional

API key for the request

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/portfolio/all/{address}' \
  --header 'Authorization: Bearer JWT'

200

200

{
  "wallet": "text",
  "positions": {
    "token": "[Circular Reference]",
    "domain": [
      {
        "title": "example.sol",
        "accountAddress": "BuwhgpzWdzMjhpFsNB1JgGUEj9gfKhfyRbwoBnAkUGpQ"
      }
    ],
    "dex": "[Circular Reference]",
    "liquidity": "[Circular Reference]",
    "staking": "[Circular Reference]",
    "farm": "[Circular Reference]",
    "vault": "[Circular Reference]",
    "margin": "[Circular Reference]",
    "lending": "[Circular Reference]",
    "validator": [
      {
        "title": "Solana",
        "valueInUSD": 100,
        "validatorAddress": "StepeLdhJ2znRjHcZdjwMWsC4nTRURNKQY8Nca82LJp",
        "stakeAccountAddress": "3kwR413BhEsTE6vMkze22qKT4txnFZPcsh7RBooFcfTE",
        "authorizedStakerAddress": "stWirqFCf2Uts1JBL1Jsd3r6VBWhgnpdPxCTe1MFjrq",
        "avg24hRewardInUSD": 0.02,
        "balance": 100,
        "status": "inactive",
        "logoURI": "https://s3.amazonaws.com/keybase_processed_uploads/91868aefb0dbe77847d806a85d7b8305_360_360.jpg"
      }
    ],
    "nftmarket": "[Circular Reference]",
    "nft": "[Circular Reference]"
  },
  "summary": {
    "positions": {
      "token": {
        "spot": {
          "totalValue": 1
        },
        "yield": {
          "totalValue": 1,
          "estimated24hReward": 1
        }
      },
      "domain": {
        "totalValue": 1
      },
      "dex": {
        "order": {
          "totalValue": 1
        },
        "unsettledBalance": {
          "totalValue": 1
        }
      },
      "liquidity": {
        "amm": {
          "totalValue": 1,
          "estimated24hReward": 1
        },
        "clmm": {
          "totalValue": 1,
          "estimated24hReward": 1,
          "totalPendingReward": 1
        }
      },
      "staking": {
        "totalValue": 1,
        "estimated24hReward": 1,
        "totalPendingReward": 1
      },
      "farm": {
        "totalValue": 1,
        "estimated24hReward": 1,
        "totalPendingReward": 1
      },
      "vault": {
        "totalValue": 1,
        "estimated24hReward": 1
      },
      "margin": {
        "totalValue": 1,
        "estimated24hReward": 1
      },
      "lending": {
        "tokenPosition": {
          "totalValue": 1,
          "estimated24hReward": 1
        },
        "leverageFarmPosition": {
          "totalValue": 1
        },
        "nftPosition": {
          "totalValue": 1
        }
      },
      "validator": {
        "totalValue": 1,
        "estimated24hReward": 1
      },
      "nftmarket": {
        "singleOrder": {
          "totalValue": 1
        },
        "poolOrder": {
          "totalValue": 1,
          "estimated24hReward": 1,
          "totalPendingReward": 1
        },
        "escrowAccount": {
          "totalValue": 1
        }
      },
      "nft": {
        "totalValue": 1
      }
    },
    "aggregated": {
      "netWorth": 1,
      "tokenValue": 1,
      "defiValue": 1,
      "nftDefiValue": 1,
      "nftValue": 1,
      "totalPendingReward": 1,
      "estimated24hReward": 1
    },
    "statuses": {
      "farm": {
        "raydium": {
          "error": null,
          "asOf": 0,
          "duration": 0
        }
      },
      "amm": {
        "solana": {
          "error": null,
          "asOf": 0,
          "duration": 0
        }
      },
      "clmm": {
        "raydium": {
          "error": null,
          "asOf": 0,
          "duration": 0
        }
      },
      "staking": {
        "raydium": {
          "error": null,
          "asOf": 0,
          "duration": 0
        }
      }
    },
    "staleJobs": [
      "text"
    ]
  },
  "status": "text"
}

Successful portfolio response with positions

Invalidates the cache for a specified wallet

delete

Invalidates the cache for a specified wallet. Next GET call will still return cached data if available, but everything will be marked as stale regardless of the data age.

Authorizations

Path parameters

addressstringrequired

Wallet address to invalidate cache for

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url '/v1/portfolio/all/{address}' \
  --header 'Authorization: Bearer JWT'

200

200

No body