Skip to content

GraphQL Queries Reference

Complete reference for all available GraphQL queries in the Agio Platform API.

System Queries

ping

Health check query to verify API connectivity.

graphql
query Ping {
  ping
}

Returns: Ping - Server status message


session

Get the current user session information.

graphql
query GetSession {
  session {
    id
    userId
    active
    allowedFunds
    allowedOrganizations
  }
}

Returns: SessionResponse

FieldTypeDescription
idStringSession ID
userIdStringCurrent user ID
activeBooleanSession active status
allowedFunds[String]List of accessible fund IDs
allowedOrganizations[String]List of accessible organization IDs

user

Get the current authenticated user.

graphql
query GetCurrentUser {
  user {
    id
    user_id
    portfolioDashboard {
      usdValue
      wallets {
        label
        usdValue
      }
    }
  }
}

Returns: User


userById

Get a specific user by their ID.

graphql
query GetUser($userId: String!) {
  userById(userId: $userId) {
    id
    user_id
  }
}

Arguments:

ArgumentTypeRequiredDescription
userIdString!YesThe user's Auth0 ID

Returns: User


Portfolio Queries

netWorthUsdByUserId

Calculate the total net worth in USD for a user.

graphql
query GetNetWorth($userId: String!, $refresh: Boolean) {
  netWorthUsdByUserId(userId: $userId, refresh: $refresh)
}

Arguments:

ArgumentTypeRequiredDefaultDescription
userIdString!Yes-The user's ID
refreshBooleanNofalseBypass cache

Returns: Float - Total net worth in USD


netWorthUsdByOrganizationId

Calculate the total net worth in USD for an organization.

graphql
query GetOrgNetWorth($organizationId: String!, $refresh: Boolean) {
  netWorthUsdByOrganizationId(organizationId: $organizationId, refresh: $refresh)
}

Arguments:

ArgumentTypeRequiredDefaultDescription
organizationIdString!Yes-The organization's ID
refreshBooleanNofalseBypass cache

Returns: Float - Total net worth in USD


digitalAssetsByUserId

List all digital assets owned by a user.

graphql
query GetUserAssets($userId: String!, $refresh: Boolean, $limit: Int, $offset: Int) {
  digitalAssetsByUserId(userId: $userId, refresh: $refresh, limit: $limit, offset: $offset) {
    name
    symbol
    value
    usdValue
    unitPriceUsd
    walletId
  }
}

Arguments:

ArgumentTypeRequiredDefaultDescription
userIdString!Yes-The user's ID
refreshBooleanNofalseBypass cache
limitIntNo-Maximum results
offsetIntNo0Skip first N results

Returns: [DigitalAssetSummary]


digitalAssetsByOrganizationId

List all digital assets owned by an organization.

graphql
query GetOrgAssets($organizationId: String!, $refresh: Boolean, $limit: Int, $offset: Int) {
  digitalAssetsByOrganizationId(organizationId: $organizationId, refresh: $refresh, limit: $limit, offset: $offset) {
    name
    symbol
    value
    usdValue
    unitPriceUsd
    walletId
  }
}

Arguments:

ArgumentTypeRequiredDefaultDescription
organizationIdString!Yes-The organization's ID
refreshBooleanNofalseBypass cache
limitIntNo-Maximum results
offsetIntNo0Skip first N results

Returns: [DigitalAssetSummary]


Wallet Queries

digitalWalletSummaryById

Get a summary of a digital wallet including balance and assets.

graphql
query GetWalletSummary($id: Int!, $refresh: Boolean) {
  digitalWalletSummaryById(id: $id, refresh: $refresh) {
    id
    label
    usdValue
    nativeCoinBalance
    assets {
      name
      symbol
      value
      usdValue
    }
  }
}

Arguments:

ArgumentTypeRequiredDefaultDescription
idInt!Yes-The wallet's database ID
refreshBooleanNofalseBypass cache

Returns: DigitalWalletSummary


digitalWalletDetailById

Get detailed wallet information including transactions, deposits, and withdrawals.

graphql
query GetWalletDetail($id: Int!, $refresh: Boolean) {
  digitalWalletDetailById(id: $id, refresh: $refresh) {
    id
    label
    usdValue
    assets {
      symbol
      value
    }
    transactions(limit: 50) {
      transactionId
      type
      status
      amount
      createdAt
    }
    deposits(limit: 20) {
      txHash
      amount
      confirmedAt
    }
    withdrawals(limit: 20) {
      txHash
      amount
      status
    }
    whitelist {
      id
      address
      label
      status
    }
  }
}

Arguments:

ArgumentTypeRequiredDefaultDescription
idInt!Yes-The wallet's database ID
refreshBooleanNofalseBypass cache

Returns: DigitalWalletDetail


Market Data Queries

coinPrice

Get the current price for a cryptocurrency.

graphql
query GetCoinPrice($symbol: String!) {
  coinPrice(symbol: $symbol) {
    id
    symbol
    price_usd
    market_cap
    market_cap_rank
    price_updated_at
  }
}

Arguments:

ArgumentTypeRequiredDescription
symbolString!YesCoin symbol (e.g., "BTC", "ETH")

Returns: CoinPrice


KYC Queries

getPotentialKycProfiles

Get KYC profiles for a user.

graphql
query GetKycProfiles($userId: String!) {
  getPotentialKycProfiles(userId: $userId) {
    id
    sumsub_email
    sumsub_first_name
    sumsub_last_name
    most_recent_review_status
    last_approved_date
    last_approved_level_name
  }
}

Arguments:

ArgumentTypeRequiredDescription
userIdString!YesThe user's ID

Returns: [KycProfile!]!


sumsubQuestionnaireDataDecrypted

Get decrypted questionnaire data from SumSub.

graphql
query GetQuestionnaireData($applicantId: String!) {
  sumsubQuestionnaireDataDecrypted(applicantId: $applicantId)
}

Arguments:

ArgumentTypeRequiredDescription
applicantIdString!YesSumSub applicant ID

Returns: jsonb - Decrypted questionnaire data


Utility Queries

userExistsByEmail

Check if a user exists by email address.

graphql
query CheckUserExists($email: String!) {
  userExistsByEmail(email: $email)
}

Arguments:

ArgumentTypeRequiredDescription
emailString!YesEmail address to check

Returns: Boolean!


queueJobById

Get the status of a background job.

graphql
query GetJobStatus($queueName: String!, $jobId: String!) {
  queueJobById(queueName: $queueName, jobId: $jobId) {
    id
    name
    status
    progress
    result
    failedReason
    createdAt
    finishedAt
  }
}

Arguments:

ArgumentTypeRequiredDescription
queueNameString!YesName of the job queue
jobIdString!YesThe job ID

Returns: BullJobResponse


Admin Queries

admin

Access admin-level operations (requires admin permissions).

graphql
query AdminAccess {
  admin {
    healthCheck {
      service
      status
      lastCheck
    }
  }
}

Returns: Admin - Admin access point with nested queries


auth0

Access Auth0 profile information.

graphql
query GetAuth0Profile {
  auth0 {
    user_id
    email
    name
    phone
    metadata {
      city
      country
      company
    }
  }
}

Returns: Auth0 - Auth0 profile data

GraphQL Queries Reference has loaded