GraphQL API Overview ​

The Agio Platform API is a GraphQL API built with Apollo Server that provides access to all platform operations including portfolio management, trading, KYC, and fund administration.

Endpoint ​

POST https://api.agiodigital.com/graphql

All requests must include the X-API-Key header. See Authentication for details.

Architecture ​

The Platform API sits between client applications and the database, providing business logic, validation, and integrations with external services.

Schema Overview ​

The API is organized into the following domains:

Portfolio & Wallets ​

Query portfolio data, wallet balances, and asset allocations.

Wallet Management ​

Create and manage digital wallets.

Trading & OTC ​

Request quotes and execute trades.

KYC & Compliance ​

Access KYC profiles and compliance data.

Fund Administration ​

Manage fund subscriptions and redemptions.

Documents & PDFs ​

Generate documents and reports.

BitGo Integration ​

Manage BitGo wallet operations.

Quick Start Example ​

Here's a simple query to test your connection:

query Ping {
  ping
}

Expected response:

{
  "data": {
    "ping": "pong"
  }
}

Query Example: Portfolio Summary ​

query GetPortfolioSummary($userId: String!) {
  netWorthUsdByUserId(userId: $userId)
  digitalAssetsByUserId(userId: $userId, limit: 10) {
    name
    symbol
    usdValue
    unitPriceUsd
  }
}

Variables:

{
  "userId": "auth0|abc123"
}

Mutation Example: Request OTC Quote ​

mutation RequestQuote($input: RequestOtcQuoteInput!) {
  requestOtcQuote(input: $input) {
    id
    fromCurrency
    toCurrency
    quoteSize
    quoteFeePerc
    expiresAt
  }
}

Variables:

{
  "input": {
    "fromCurrency": "BTC",
    "toCurrency": "USD",
    "size": 1.5,
    "side": "SELL"
  }
}

Caching ​

Many queries support a refresh parameter to bypass caching:

query GetWallet($id: Int!) {
  digitalWalletSummaryById(id: $id, refresh: true) {
    label
    usdValue
    assets {
      symbol
      value
    }
  }
}

Cache control directives:

• Most queries cache for 30 seconds by default
• Use refresh: true for real-time data
• Some aggregations cache for 2 minutes

Pagination ​

List queries support limit and offset parameters:

query GetAssets($userId: String!, $limit: Int, $offset: Int) {
  digitalAssetsByUserId(userId: $userId, limit: $limit, offset: $offset) {
    name
    symbol
    usdValue
  }
}

Subscriptions ​

Real-time data is available via GraphQL subscriptions:

subscription OrderBookUpdates($productIds: [String!]) {
  orderBookUpdates(productIds: $productIds) {
    productId
    bids {
      price
      size
    }
    asks {
      price
      size
    }
  }
}

Next Steps ​

• Queries Reference - Complete list of available queries
• Mutations Reference - Complete list of available mutations
• Types Reference - GraphQL type definitions
• Examples - Full code examples