Centrifuge API

openapi: 3.1.0
info:
  title: Centrifuge API
  version: '2026-10-29'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-29: 7 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Centrifuge has published no machine-readable contract that the
    pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 1
    documentation: 6
    pages-with-code: 1
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-29'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://docs.centrifuge.io/developer/centrifuge-api
  - https://docs.centrifuge.io/developer/legacy/pod
servers:
- url: https://api.centrifuge.io
paths:
  /bridge/quote:
    get:
      operationId: get_bridge_quote
      tags:
      - Bridge
      summary: Prices a single transfer along a route and returns the parameters needed to execute it.
      x-source: https://docs.centrifuge.io/developer/centrifuge-api
      parameters:
      - name: fromChain
        in: query
        required: true
        schema:
          type: string
        description: EVM chain ID of the source chain
      - name: toChain
        in: query
        required: true
        schema:
          type: string
        description: EVM chain ID of the destination chain
      - name: fromToken
        in: query
        required: true
        schema:
          type: string
        description: Token contract address on the source chain
      - name: fromAmount
        in: query
        required: true
        schema:
          type: string
        description: Amount to transfer, in the token's smallest unit
      - name: toAddress
        in: query
        required: true
        schema:
          type: string
        description: Recipient address on the destination chain
      - name: fromAddress
        in: query
        required: false
        schema:
          type: string
        description: Sender address; used as the native-fee refund address on the source chain
      - name: toToken
        in: query
        required: false
        schema:
          type: string
        description: Token address on the destination chain (must resolve to the same share class)
      - name: slippage
        in: query
        required: false
        schema:
          type: string
        description: Accepted for compatibility; ignored, since transfers are 1:1
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBridgeQuoteResponse'
      x-evidence:
        kind: documentation
  /bridge/routes:
    get:
      operationId: get_bridge_routes
      tags:
      - Bridge
      summary: Returns every available cross-chain transfer route.
      x-source: https://docs.centrifuge.io/developer/centrifuge-api
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBridgeRoutesResponse'
      x-evidence:
        kind: documentation
  /bridge/status:
    get:
      operationId: get_bridge_status
      tags:
      - Bridge
      summary: Returns the status of a transfer, given its source-chain transaction hash.
      x-source: https://docs.centrifuge.io/developer/centrifuge-api
      parameters:
      - name: txHash
        in: query
        required: true
        schema:
          type: string
        description: Source-chain transaction hash
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBridgeStatusResponse'
      x-evidence:
        kind: documentation
  /bridge/transaction/{txhash}:
    get:
      operationId: get_bridge_transaction_txhash
      tags:
      - Bridge
      summary: Returns the status of a transfer, given its source-chain transaction hash.
      x-source: https://docs.centrifuge.io/developer/centrifuge-api
      parameters:
      - name: txhash
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBridgeTransactionTxhashResponse'
      x-evidence:
        kind: documentation
  /ping:
    get:
      operationId: get_ping
      tags:
      - Ping
      summary: GET /ping
      x-source: https://docs.centrifuge.io/developer/legacy/pod
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPingResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X GET \"http://localhost:8082/ping\" -H \"accept: application/json\" \n It will return (e.g. Catalyst): \n {\"version\"\
          :\"...\",\"network\":\"catalyst\"} \n Accounts ​ \n The Accounts section of our swagger API docs provides\nan overview of all the endpoints\
          \ available for handling accounts. \n An account is the POD representation of the user that is performing various operations. The identity\
          \ of this account\n"
  /tokens/{address}/price:
    get:
      operationId: get_tokens_address_price
      tags:
      - Tokens
      summary: Returns the current price of a token by its contract address, formatted as a decimal string.
      x-source: https://docs.centrifuge.io/developer/centrifuge-api
      parameters:
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTokensAddressPriceResponse'
      x-evidence:
        kind: documentation
  /tokens/{address}/total-issuance:
    get:
      operationId: get_tokens_address_total_issuance
      tags:
      - Tokens
      summary: Returns the total issuance (supply) of a token by its contract address, formatted as a decimal string adjusted for the token's
        decimals.
      x-source: https://docs.centrifuge.io/developer/centrifuge-api
      parameters:
      - name: address
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTokensAddressTotalIssuanceResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetBridgeQuoteResponse:
      type: object
      properties:
        tool:
          type: string
          description: Bridge identifier, centrifuge
        standard:
          type: string
          description: Transfer standard, CentrifugeV31
        fromChainId:
          type: integer
          description: EVM chain ID of the source chain
        toChainId:
          type: integer
          description: EVM chain ID of the destination chain
        fromToken:
          type: object
          description: 'Source token: address, chainId, symbol, name, decimals'
        toToken:
          type: object
          description: 'Destination token: address, chainId, symbol, name, decimals'
        fromAmount:
          type: string
          description: Amount sent, in the token's smallest unit
        toAmount:
          type: string
          description: Amount received, in the token's smallest unit (equals fromAmount)
        estimate:
          type: object
          description: 'Pricing: toAmountMin, approvalAddress, executionDuration (seconds), feeCosts (array), gasEstimate'
        parameters:
          type: object
          description: Decoded arguments for the token bridge send call to submit onchain, or null
    GetBridgeRoutesResponse:
      type: object
      properties:
        routes:
          type: array
          description: Array of available cross-chain transfer routes
        tokenId:
          type: string
          description: Share class token identifier
        tokenName:
          type: string
          description: Human-readable token name
        fromAddress:
          type: string
          description: Token contract address on the source chain
        toAddress:
          type: string
          description: Token contract address on the destination chain
        fromChainId:
          type: string
          description: EVM chain ID of the source chain
        fromChainName:
          type: string
          description: Name of the source chain
        toChainId:
          type: string
          description: EVM chain ID of the destination chain
        toChainName:
          type: string
          description: Name of the destination chain
        minTransferSize:
          type: string
          description: Minimum transfer amount, in the token's smallest unit
        maxTransferSize:
          type: string
          description: Maximum transfer amount, in the token's smallest unit
        decimals:
          type: integer
          description: Token decimals
        estimatedDuration:
          type: integer
          description: Estimated transfer time, in seconds
        estimatedGas:
          type: integer
          description: Estimated gas for the destination-chain execution
        standard:
          type: string
          description: Transfer standard, CentrifugeV31
    GetBridgeStatusResponse:
      type: object
      properties:
        transactionId:
          type: string
          description: Cross-chain transfer identifier
        tool:
          type: string
          description: centrifuge
        status:
          type: string
          description: NOT_FOUND, PENDING, or DONE
        substatus:
          type: string
          description: WAIT_SOURCE_CONFIRMATIONS, WAIT_DESTINATION_TRANSACTION, COMPLETED, or PARTIAL
        substatusMessage:
          type: string
          description: Human-readable detail, or null
        toAddress:
          type: string
          description: Recipient address on the destination chain
        sending:
          type: object
          description: 'Source-chain leg: txHash, txLink, chainId, amount, token, gasPrice, timestamp'
        receiving:
          type: object
          description: 'Destination-chain leg once delivered: txHash, txLink, chainId, tokenAddress, tokenAmount, timestamp; null until then'
    GetBridgeTransactionTxhashResponse:
      type: object
      properties:
        transactionId:
          type: string
          description: Cross-chain transfer identifier
        tool:
          type: string
          description: centrifuge
        status:
          type: string
          description: NOT_FOUND, PENDING, or DONE
        substatus:
          type: string
          description: WAIT_SOURCE_CONFIRMATIONS, WAIT_DESTINATION_TRANSACTION, COMPLETED, or PARTIAL
        substatusMessage:
          type: string
          description: Human-readable detail, or null
        toAddress:
          type: string
          description: Recipient address on the destination chain
        sending:
          type: object
          description: 'Source-chain leg: txHash, txLink, chainId, amount, token, gasPrice, timestamp'
        receiving:
          type: object
          description: 'Destination-chain leg once delivered: txHash, txLink, chainId, tokenAddress, tokenAmount, timestamp; null until then'
    GetPingResponse:
      type: object
      properties:
        version:
          type: string
        network:
          type: string
    GetTokensAddressPriceResponse:
      type: object
      properties:
        price:
          type: string
          description: Token price
    GetTokensAddressTotalIssuanceResponse:
      type: object
      properties:
        total-issuance:
          type: string
          description: Total issuance returned
tags:
- name: Bridge
- name: Ping
- name: Tokens