Centrifuge API

The Centrifuge API is a public, read-only GraphQL endpoint for querying onchain data from the Centrifuge protocol across multiple networks. Send any GraphQL-compliant POST request to https://api.centrifuge.io. No authentication required. For interactive exploration, open the GraphiQL UI and use Ctrl + Space to trigger autocomplete.

All queries accept these standard parameters:

Parameter	Type	Description
`limit`	`Int`	Max records to return (default 100, max 1000)
`where`	`Filter`	Entity-specific filter criteria (see each section below)
`orderBy`	`String`	Column to sort by (default: primary key)
`orderDirection`	`String`	`"asc"` or `"desc"` (default: `"asc"`)

Pools

A pool is the top-level entity that groups together share classes (tokens), vaults, and holdings across multiple networks. Each pool can issue several tokens, deploy vaults on different chains, and manage assets through a unified on-chain structure.

Filter	Type	Description
`id`	`BigInt`	Pool ID
`centrifugeId`	`String`	Centrifuge-specific pool identifier
`name`	`String`	Pool name (supports `_contains`, `_starts_with`)
`isActive`	`Boolean`	Whether the pool is currently active

POSThttps://api.centrifuge.io

query GetActivePools {
pools(
  where: { isActive: true, name_not: null }
  limit: 5
) {
  items {
    id
    name
    centrifugeId
    isActive
    tokens {
      items {
        id
        name
        symbol
        totalIssuance
        tokenPrice
      }
    }
  }
}
}

Tokens

A token (or share class) represents ownership in a pool. TVL per token can be calculated as totalIssuance * tokenPrice, adjusted for decimals.

Filter	Type	Description
`id`	`String`	Token address
`poolId`	`BigInt`	Pool the token belongs to
`name`	`String`	Token name
`symbol`	`String`	Token symbol

POSThttps://api.centrifuge.io

query GetTokenById {
tokens(
  where: { id: "0x00010000000000060000000000000001" }
) {
  items {
    id
    name
    totalIssuance
    tokenPrice
    pool {
      asset {
        decimals
      }
    }
  }
}
}

Vaults

A vault is the entry point for investors on a specific chain. Each vault connects a pool's share class token to a deposit asset on a spoke chain, handling deposits, redemptions, and token conversions for that particular network.

Filter	Type	Description
`id`	`String`	Vault contract address
`centrifugeId`	`String`	Centrifuge chain identifier
`poolId`	`BigInt`	Pool the vault belongs to
`tokenId`	`String`	Share class token ID
`isActive`	`Boolean`	Whether the vault is currently active
`assetAddress`	`String`	Deposit asset contract address

POSThttps://api.centrifuge.io

query GetVaultsByPool {
vaults(
  where: { poolId: "281474976710659" }
  limit: 10
) {
  items {
    id
    centrifugeId
    poolId
    tokenId
    assetAddress
    isActive
    status
    blockchain {
      centrifugeId
      name
    }
  }
}
}

Holdings

Holding escrows track the custodial asset positions for each pool on spoke chains. Each escrow holds a specific asset amount and price, linked to the on-chain asset contract.

Filter	Type	Description
`poolId`	`BigInt`	Pool the escrow belongs to
`centrifugeId`	`String`	Centrifuge chain identifier
`tokenId`	`String`	Share class token ID
`assetId`	`BigInt`	Asset identifier
`assetAddress`	`String`	Asset contract address

POSThttps://api.centrifuge.io

query GetHoldingEscrowsByPool {
holdingEscrows(
  where: { poolId: "281474976710659" }
  limit: 5
) {
  items {
    centrifugeId
    assetAmount
    assetPrice
    asset {
      name
      symbol
      decimals
      address
    }
  }
}
}

Investor transactions

Investor transactions record every invest, redeem, and claim action executed by investors in the protocol.

Filter	Type	Description
`account`	`String`	Investor wallet address
`centrifugeId`	`String`	Centrifuge chain identifier
`type`	`InvestorTransactionType`	Transaction type (e.g. `DEPOSIT_REQUEST_UPDATED`, `REDEEM_CLAIMED`, `TRANSFER_IN`)
`poolId`	`BigInt`	Pool ID
`tokenId`	`String`	Share class token ID

POSThttps://api.centrifuge.io

query GetTransactionsByInvestor {
investorTransactions(
  where: {
    account: "0xa2da14a5012b67c609e52f5e6f7372853c2eb5aa"
  }
  limit: 5
  orderBy: "createdAt"
  orderDirection: "desc"
) {
  items {
    txHash
    centrifugeId
    type
    account
    poolId
    tokenId
    currencyAmount
    tokenAmount
    tokenPrice
    createdAt
    blockchain {
      centrifugeId
      name
    }
  }
}
}

Investor positions

Token instance positions represent an investor's share class token balance on a specific chain. Query by account address to see all holdings across networks.

Filter	Type	Description
`accountAddress`	`String`	Investor wallet address
`centrifugeId`	`String`	Centrifuge chain identifier
`tokenId`	`String`	Share class token ID
`isFrozen`	`Boolean`	Whether the position is frozen
`balance`	`BigInt`	Token balance (supports `_gt`, `_lt`)

POSThttps://api.centrifuge.io

query GetPositionsByInvestor {
tokenInstancePositions(
  where: {
    accountAddress: "0xeaafba6ae4f1c428546706d4b3b6a72fda4bac98"
    balance_gt: "0"
  }
) {
  items {
    tokenId
    centrifugeId
    accountAddress
    balance
    isFrozen
    tokenInstance {
      address
      blockchain {
        centrifugeId
        name
      }
    }
  }
}
}

Yield

Token snapshots include yield metrics computed from the token's price history. Yield values are expressed as decimal returns (e.g. 0.05 = 5%). Use the most recent snapshot for current yields, or query a time series to chart yield over time.

Field	Description
`yieldSinceInception`	Total return since the token was first issued
`yieldYtd`	Year-to-date return
`yieldTtm`	Trailing twelve months return
`yield7d` / `yield30d`	Simple return over the trailing 7 / 30 days
`yield7d360` / `yield7d365`	7-day return annualized on a 360 / 365 day basis
`yield30d360`	30-day return annualized on a 360 day basis
`yield30dComp360` / `yield30dComp365`	30-day return compounded and annualized on a 360 / 365 day basis

Filter	Type	Description
`id`	`String`	Share class token ID
`timestamp`	`String`	Snapshot timestamp (supports `_gt`, `_lt`, `_gte`, `_lte`)

POSThttps://api.centrifuge.io

query GetTokenYields {
tokenSnapshots(
  where: { id: "0x00010000000000060000000000000001" }
  orderBy: "timestamp"
  orderDirection: "desc"
  limit: 1
) {
  items {
    id
    timestamp
    tokenPrice
    yieldSinceInception
    yieldYtd
    yieldTtm
    yield30d
    yield30d360
    yield7d
    yield7d360
    yield7d365
    yield30dComp360
    yield30dComp365
  }
}
}

Snapshots

Snapshots capture entity state at specific points in time. Available for pools, tokens, token instances, and holdings. All snapshots share common fields: timestamp, blockNumber, trigger, triggerTxHash, and triggerChainId.

Entity	Description
`PoolSnapshot`	Pool state at a point in time
`TokenSnapshot`	Token details at a specific moment
`TokenInstanceSnapshot`	Token instance status on a spoke chain
`HoldingSnapshot`	Pool asset positions across chains
`HoldingEscrowSnapshot`	Escrow asset amounts and prices over time

POSThttps://api.centrifuge.io

{
tokenInstanceSnapshots(
  orderBy: "timestamp"
  orderDirection: "asc"
  where: {
    tokenId: "0x00010000000000060000000000000001"
    trigger_starts_with: "ethereum"
  }
) {
  items {
    tokenId
    triggerChainId
    trigger
    timestamp
    totalIssuance
    tokenPrice
  }
}
}

Other entities

Beyond the main entities above, the API exposes a full set of indexed resources:

Infrastructure

Entity	Description
`Blockchain`	All blockchains the indexer is currently tracking
`Deployment`	Protocol contracts and addresses deployed to a blockchain
`PoolSpokeBlockchain`	Mapping of pools to their spoke chain deployments

Protocol hub resources

Entity	Description
`Holding`	Pool-level asset position with quantity and valuation
`HoldingAccount`	Categorized asset account for a pool (asset, equity, liability, etc.)
`AssetRegistration`	Successful registration of an asset on a hub chain
`OnOffRampManager`	Cross-chain asset movement for pools
`OfframpRelayer`	Authorized services that process withdrawal requests
`OnRampAsset`	Token types investors can deposit for pool shares
`OffRampAddress`	Pre-approved withdrawal destinations
`Policy`	Merkle tree root representing allowed operations for a strategist
`MerkleProofManager`	Enables strategists to execute multi-call operations on behalf of pools

Protocol spoke resources

Entity	Description
`Asset`	An asset on a spoke chain
`TokenInstance`	Instance of a share class token on a spoke chain
`Escrow`	Custodial wallet for pool assets on a spoke chain

Cross-chain communication

Entity	Description
`CrosschainPayload`	Data content sent from one blockchain to another
`CrosschainMessage`	Structured communication between blockchains
`Adapter`	Bridges that relay payloads between networks
`AdapterWiring`	Configuration linking adapter addresses across chains
`AdapterParticipation`	Tracks adapter involvement in cross-chain transfers

Transactional data

Entity	Description
`OutstandingInvest`	Pending invest order awaiting fulfillment
`OutstandingRedeem`	Pending redeem order awaiting fulfillment
`PendingInvestOrder`	Pending invest order with queued and pending amounts
`PendingRedeemOrder`	Pending redeem order with queued and pending amounts
`InvestOrder`	Approved invest order (tracks approval to claim)
`RedeemOrder`	Approved redeem order (tracks approval to claim)
`VaultInvestOrder`	Cross-chain invest order via a vault
`VaultRedeemOrder`	Cross-chain redeem order via a vault
`EpochOutstandingInvest`	Aggregated outstanding invest orders (epoch-level)
`EpochOutstandingRedeem`	Aggregated outstanding redeem orders (epoch-level)
`EpochInvestOrder`	Approved invest order at epoch level
`EpochRedeemOrder`	Approved redeem order at epoch level
`TokenInstancePosition`	Investor position holding a share class token

Actors and participants

Entity	Description
`Account`	User-owned address (UOA) in the protocol
`PoolManager`	Manager of a pool (hub or spoke)
`WhitelistedInvestor`	Investor allowed to invest in a pool

Filtering, sorting, and pagination

Filters

Use the where argument to filter records. Filter options are available for every column:

Filter suffix	Column types	Matches records where column...
(none)	All	equals the value
`_not`	All	does not equal the value
`_in`	Primitives, enums	is one of the values
`_not_in`	Primitives, enums	is not one of the values
`_gt` / `_lt`	Numeric	is greater / less than the value
`_gte` / `_lte`	Numeric	is greater/less than or equal to the value
`_contains`	String	contains the substring
`_not_contains`	String	does not contain the substring
`_starts_with` / `_ends_with`	String	starts / ends with the substring
`_not_starts_with` / `_not_ends_with`	String	does not start / end with the substring
`_has`	Lists	has the value as an element
`_not_has`	Lists	does not have the value as an element

Compose filters using the AND and OR operators, which accept an array of filter objects.

Sorting

Use orderBy and orderDirection to sort results:

Argument	Default	Options
`orderBy`	Primary key	Any column name
`orderDirection`	`"asc"`	`"asc"` or `"desc"`

Pagination

The API uses cursor-based pagination. For details, see the Ponder.sh pagination docs.

Filter example

This query combines filtering, sorting, and pagination: it fetches token instance snapshots for a specific token, filtered to Ethereum triggers, sorted chronologically.

POSThttps://api.centrifuge.io

{
tokenInstanceSnapshots(
  orderBy: "timestamp"
  orderDirection: "asc"
  where: {
    tokenId: "0x00010000000000060000000000000001"
    trigger_starts_with: "ethereum"
  }
  limit: 5
) {
  items {
    tokenId
    trigger
    timestamp
    totalIssuance
    tokenPrice
  }
}
}

Limits and performance

Limit	Value
Max page size	1000 records per page
Request timeout	30 seconds

Performance tips:

Limit query depth: each nested level adds a sequential database query. Keep queries to 2 levels deep or fewer.
Use pagination: fetch records in smaller chunks with cursor-based pagination to reduce database load.

Supported networks

See the Deployments page for the full list of supported networks and contract addresses.

Data freshness

Data is typically available within 1-2 minutes of onchain confirmation. Historical snapshots are maintained at daily intervals, with some entities also snapshotted on specific trigger events.

Token REST API

The API also exposes REST endpoints for simple token lookups. All endpoints return JSON responses.

Token price

Returns the current price of a token by its contract address, formatted as a decimal string.

GET /tokens/:address/price

Parameters

Field	Description
`address`	Token contract address on any supported network

Response

Status	Description
`200`	Token price returned
`404`	Token address not found, or price not set

GET

Token total issuance

Returns the total issuance (supply) of a token by its contract address, formatted as a decimal string adjusted for the token's decimals.

GET /tokens/:address/total-issuance

Parameters

Field	Description
`address`	Token contract address on any supported network

Response

Status	Description
`200`	Total issuance returned
`404`	Token address not found, decimals not set, or total issuance not set

GET

Bridge REST API

The Bridge REST API is the offchain interface for moving Centrifuge tokens across chains. It exposes route discovery, quoting, and transfer-status endpoints that bridges and aggregators use to integrate Centrifuge token transfers, following the conventions those integrators expect.

All endpoints are served under https://api.centrifuge.io/bridge and return JSON. No authentication required.

Centrifuge share class tokens are natively multichain: the same token is deployed on several chains and moves between them through the protocol's own messaging layer rather than a wrapped-asset bridge. Transfers are 1:1. The amount received equals the amount sent, and the bridge fee is paid separately in the source chain's native token. Routes are available where the token bridge is deployed (currently Ethereum and Base).

Routes

Returns every available cross-chain transfer route. Each entry is a directional pair: a token on a source chain that can be moved to the same token on a destination chain.

GET /bridge/routes

Response

The response is an object with a routes array. Each route contains:

Field	Type	Description
`tokenId`	`String`	Share class token identifier
`tokenName`	`String`	Human-readable token name
`fromAddress`	`String`	Token contract address on the source chain
`toAddress`	`String`	Token contract address on the destination chain
`fromChainId`	`String`	EVM chain ID of the source chain
`fromChainName`	`String`	Name of the source chain
`toChainId`	`String`	EVM chain ID of the destination chain
`toChainName`	`String`	Name of the destination chain
`minTransferSize`	`String`	Minimum transfer amount, in the token's smallest unit
`maxTransferSize`	`String`	Maximum transfer amount, in the token's smallest unit (`uint128` max means unlimited)
`decimals`	`Int`	Token decimals
`estimatedDuration`	`Int`	Estimated transfer time, in seconds
`estimatedGas`	`Int`	Estimated gas for the destination-chain execution
`standard`	`String`	Transfer standard, `CentrifugeV31`

GET

Quote

Prices a single transfer along a route and returns the parameters needed to execute it.

GET /bridge/quote

Query parameters

Parameter	Required	Description
`fromChain`	yes	EVM chain ID of the source chain
`toChain`	yes	EVM chain ID of the destination chain
`fromToken`	yes	Token contract address on the source chain
`fromAmount`	yes	Amount to transfer, in the token's smallest unit
`toAddress`	yes	Recipient address on the destination chain
`fromAddress`	no	Sender address; used as the native-fee refund address on the source chain
`toToken`	no	Token address on the destination chain (must resolve to the same share class)
`slippage`	no	Accepted for compatibility; ignored, since transfers are 1:1

Response

toAmount equals fromAmount (1:1 transfer). Fees are returned in estimate.feeCosts and paid in the source chain's native token (included: false), not deducted from the amount.

Field	Type	Description
`tool`	`String`	Bridge identifier, `centrifuge`
`standard`	`String`	Transfer standard, `CentrifugeV31`
`fromChainId`	`Int`	EVM chain ID of the source chain
`toChainId`	`Int`	EVM chain ID of the destination chain
`fromToken`	`Object`	Source token: `address`, `chainId`, `symbol`, `name`, `decimals`
`toToken`	`Object`	Destination token: `address`, `chainId`, `symbol`, `name`, `decimals`
`fromAmount`	`String`	Amount sent, in the token's smallest unit
`toAmount`	`String`	Amount received, in the token's smallest unit (equals `fromAmount`)
`estimate`	`Object`	Pricing: `toAmountMin`, `approvalAddress`, `executionDuration` (seconds), `feeCosts` (array), `gasEstimate`
`parameters`	`Object`	Decoded arguments for the token bridge `send` call to submit onchain, or `null`

GET

Transfer status

Returns the status of a transfer, given its source-chain transaction hash. The endpoint responds with 200 and a NOT_FOUND status even before the transaction is indexed, so it is safe to poll.

GET /bridge/status?txHash=:txHash
GET /bridge/transaction/:txHash

Response

Field	Type	Description
`transactionId`	`String`	Cross-chain transfer identifier
`tool`	`String`	`centrifuge`
`status`	`String`	`NOT_FOUND`, `PENDING`, or `DONE`
`substatus`	`String`	`WAIT_SOURCE_CONFIRMATIONS`, `WAIT_DESTINATION_TRANSACTION`, `COMPLETED`, or `PARTIAL`
`substatusMessage`	`String`	Human-readable detail, or `null`
`toAddress`	`String`	Recipient address on the destination chain
`sending`	`Object`	Source-chain leg: `txHash`, `txLink`, `chainId`, `amount`, `token`, `gasPrice`, `timestamp`
`receiving`	`Object`	Destination-chain leg once delivered: `txHash`, `txLink`, `chainId`, `tokenAddress`, `tokenAmount`, `timestamp`; `null` until then

GET

Pools​

Tokens​

Vaults​

Holdings​

Investor transactions​

Investor positions​

Yield​

Snapshots​

Other entities​

Infrastructure​

Protocol hub resources​

Protocol spoke resources​

Cross-chain communication​

Transactional data​

Actors and participants​

Filtering, sorting, and pagination​

Filters​

Sorting​

Pagination​

Filter example​

Limits and performance​

Supported networks​

Data freshness​

Token REST API​

Token price​

Parameters​

Response​

Token total issuance​

Parameters​

Response​

Bridge REST API​

Routes​

Response​

Quote​

Query parameters​

Response​

Transfer status​

Response​

Pools

Tokens

Vaults

Holdings

Investor transactions

Investor positions

Yield

Snapshots

Other entities

Infrastructure

Protocol hub resources

Protocol spoke resources

Cross-chain communication

Transactional data

Actors and participants

Filtering, sorting, and pagination

Filters

Sorting

Pagination

Filter example

Limits and performance

Supported networks

Data freshness

Token REST API

Token price

Parameters

Response

Token total issuance

Parameters

Response

Bridge REST API

Routes

Response

Quote

Query parameters

Response

Transfer status

Response