Skip to main content
POST
/
wallets
/
portfolio
Wallet Portfolio
curl --request POST \
  --url http://localhost:8000/v2/wallets/portfolio \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "chain_ids": [
    1,
    8453,
    137
  ],
  "chain_type": "EVM",
  "force_refresh": false,
  "min_balance_usd": 1,
  "wallet_address": "0x1234...abcd"
}
'
{
  "chain_type": "EVM",
  "currencies": [
    {
      "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "balance": {
        "raw_amount": "2400000",
        "ui_amount": 2.4,
        "ui_amount_display": "2.4",
        "value_usd": 123.45
      },
      "chain_id": 1,
      "chain_logo_uri": "https://assets.coingecko.com/asset_platforms/images/279/standard/ethereum.png",
      "decimals": 6,
      "logo_uri": "https://assets.coingecko.com/coins/images/6319/large/usdc.png",
      "price_usd": 1,
      "symbol": "USDC"
    }
  ],
  "wallet_address": "0x1234...abcd"
}

Documentation Index

Fetch the complete documentation index at: https://docs.coinvoyage.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-API-KEY
string
header
required

Headers

X-API-KEY
string
required

API key for authentication

Body

application/json
wallet_address
string
required
Example:

"0x1234...abcd"

chain_type
enum<string>
required
Available options:
EVM,
SOL,
SUI,
UTXO
Example:

"EVM"

chain_ids
enum<integer>[]
Available options:
1,
10,
56,
137,
8453,
42161,
20000000000001,
30000000000001,
30000000000002
Example:
[1, 8453, 137]
min_balance_usd
number | null
Example:

1

force_refresh
boolean
Example:

false

Response

Portfolio scan succeeded

wallet_address
string
required
Example:

"0x1234...abcd"

chain_type
enum<string>
required
Available options:
EVM,
SOL,
SUI,
UTXO
Example:

"EVM"

scanned_at
string<date-time>
required
expires_at
string<date-time>
required
currencies
object[]
required