> ## Documentation Index
> Fetch the complete documentation index at: https://yieldxyz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit transaction

> Submit the transaction to the blockchain.



## OpenAPI

````yaml post /v1/transactions/{transactionId}/submit
openapi: 3.0.0
info:
  title: Yield.xyz API
  description: API Documentation
  version: '1.0'
  contact: {}
servers:
  - url: https://api.yield.xyz
    description: Production environment
  - url: https://api.staging.yield.xyz
    description: Staging environment
  - url: http://localhost:3000
    description: Local development
security: []
tags:
  - name: Discovery
    description: Browse and discover yield opportunities, networks, and providers
  - name: Portfolio
    description: User-specific balances, activity, and rewards
  - name: Actions
    description: Generate transactions to enter, exit, and manage yields
externalDocs:
  description: For more information
  url: https://docs.yield.xyz
paths:
  /v1/transactions/{transactionId}/submit:
    post:
      tags:
        - Actions
      summary: Submit transaction
      description: Submit the transaction to the blockchain.
      operationId: TransactionsController_submitTransaction
      parameters:
        - name: transactionId
          required: true
          in: path
          description: The unique identifier of the transaction
          example: tx_123abc
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitTransactionDto'
      responses:
        '200':
          description: Transaction successfully submitted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDto'
        '400':
          description: Invalid transaction format
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Invalid API key
                  error:
                    type: string
                    example: Unauthorized
                  statusCode:
                    type: number
                    example: 401
        '404':
          description: Transaction not found with the specified ID
        '429':
          description: Rate limit exceeded
          headers:
            x-ratelimit-limit:
              description: Request limit per window
              schema:
                type: string
            x-ratelimit-remaining:
              description: Remaining requests (will be 0)
              schema:
                type: string
            x-ratelimit-reset:
              description: Unix timestamp when window resets
              schema:
                type: string
            retry-after:
              description: Seconds to wait before retrying
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Rate limit exceeded
                  error:
                    type: string
                    example: Too Many Requests
                  statusCode:
                    type: number
                    example: 429
                  retryAfter:
                    type: number
                    example: 30
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Internal server error
                  error:
                    type: string
                    example: Internal Server Error
                  statusCode:
                    type: number
                    example: 500
      security:
        - ApiKey: []
components:
  schemas:
    SubmitTransactionDto:
      type: object
      properties:
        signedTransaction:
          type: string
          description: Encoded signed transaction to submit to the blockchain
          example: >-
            0aba010aa0010a232f636f736d6f732e7374616b696e672e763162657461312e4d736744656c656761746512790a2a696e6a316a61366664646e6e33727272677137646d6a757a6b71363279376d68346675346b6e656d37791231696e6a76616c6f7065723167346436646d766e706737773779756779366b706c6e6470376a70666d66336b7274736368701a180a03696e6a121131303030303030303030303030303030301215766961205374616b654b6974204349442d31303039129e010a7e0a740a2d2f696e6a6563746976652e63727970746f2e763162657461312e657468736563703235366b312e5075624b657912430a41042aec99dce37ea3d8f11b44da62bce0e885f0ba5b309382954babec76eb138cb0bb84f4f24b9f63143f2ce66923b2dd3ee55475e680a7b992b9cbc17941f6486312040a0208011802121c0a160a03696e6a120f31383732303030303030303030303010d0b4471a0b696e6a6563746976652d312092c35b
      required:
        - signedTransaction
    TransactionDto:
      type: object
      properties:
        id:
          type: string
          description: Unique transaction identifier
          example: tx_123abc
        title:
          type: string
          description: Display title for the transaction
          example: Approve USDC
        network:
          type: string
          description: Network this transaction is for
          enum:
            - ethereum
            - ethereum-goerli
            - ethereum-holesky
            - ethereum-sepolia
            - ethereum-hoodi
            - arbitrum
            - base
            - base-sepolia
            - gnosis
            - optimism
            - polygon
            - polygon-amoy
            - starknet
            - zksync
            - linea
            - unichain
            - monad-testnet
            - avalanche-c
            - avalanche-c-atomic
            - avalanche-p
            - binance
            - celo
            - fantom
            - harmony
            - moonriver
            - okc
            - viction
            - core
            - sonic
            - katana
            - hyperevm
            - agoric
            - akash
            - axelar
            - band-protocol
            - bitsong
            - canto
            - chihuahua
            - comdex
            - coreum
            - cosmos
            - crescent
            - cronos
            - cudos
            - desmos
            - dydx
            - evmos
            - fetch-ai
            - gravity-bridge
            - injective
            - irisnet
            - juno
            - kava
            - ki-network
            - mars-protocol
            - nym
            - okex-chain
            - onomy
            - osmosis
            - persistence
            - quicksilver
            - regen
            - secret
            - sentinel
            - sommelier
            - stafi
            - stargaze
            - stride
            - teritori
            - tgrade
            - umee
            - sei
            - mantra
            - celestia
            - saga
            - zetachain
            - dymension
            - humansai
            - neutron
            - polkadot
            - kusama
            - westend
            - bittensor
            - binancebeacon
            - cardano
            - near
            - solana
            - solana-devnet
            - stellar
            - stellar-testnet
            - sui
            - tezos
            - tron
            - ton
            - ton-testnet
          example: ethereum
        status:
          type: string
          description: Current status of the transaction
          enum:
            - NOT_FOUND
            - CREATED
            - BLOCKED
            - WAITING_FOR_SIGNATURE
            - SIGNED
            - BROADCASTED
            - PENDING
            - CONFIRMED
            - FAILED
            - SKIPPED
          example: PENDING
        type:
          type: string
          description: Type of transaction operation
          enum:
            - SWAP
            - DEPOSIT
            - APPROVAL
            - STAKE
            - CLAIM_UNSTAKED
            - CLAIM_REWARDS
            - RESTAKE_REWARDS
            - UNSTAKE
            - SPLIT
            - MERGE
            - LOCK
            - UNLOCK
            - SUPPLY
            - BRIDGE
            - VOTE
            - REVOKE
            - RESTAKE
            - REBOND
            - WITHDRAW
            - WITHDRAW_ALL
            - CREATE_ACCOUNT
            - REVEAL
            - MIGRATE
            - DELEGATE
            - UNDELEGATE
            - UTXO_P_TO_C_IMPORT
            - UTXO_C_TO_P_IMPORT
            - WRAP
            - UNWRAP
            - UNFREEZE_LEGACY
            - UNFREEZE_LEGACY_BANDWIDTH
            - UNFREEZE_LEGACY_ENERGY
            - UNFREEZE_BANDWIDTH
            - UNFREEZE_ENERGY
            - FREEZE_BANDWIDTH
            - FREEZE_ENERGY
            - UNDELEGATE_BANDWIDTH
            - UNDELEGATE_ENERGY
            - P2P_NODE_REQUEST
            - CREATE_EIGENPOD
            - VERIFY_WITHDRAW_CREDENTIALS
            - START_CHECKPOINT
            - VERIFY_CHECKPOINT_PROOFS
            - QUEUE_WITHDRAWALS
            - COMPLETE_QUEUED_WITHDRAWALS
            - LUGANODES_PROVISION
            - LUGANODES_EXIT_REQUEST
            - INFSTONES_PROVISION
            - INFSTONES_EXIT_REQUEST
            - INFSTONES_CLAIM_REQUEST
          example: STAKE
        hash:
          type: string
          description: Transaction hash (available after broadcast)
          nullable: true
          example: 0x1234567890abcdef...
        createdAt:
          format: date-time
          type: string
          description: When the transaction was created
        broadcastedAt:
          format: date-time
          type: string
          description: When the transaction was broadcasted to the network
          nullable: true
        signedTransaction:
          type: string
          description: Signed transaction data (ready for broadcast)
          nullable: true
        unsignedTransaction:
          description: The unsigned transaction data to be signed by the wallet
          oneOf:
            - type: string
              description: Serialized transaction data
            - type: object
              description: Transaction object (for non-EVM chains)
          nullable: true
          example: >-
            0x02f87082012a022f2f83018000947a250d5630b4cf539739df2c5dacb4c659f2488d880de0b6b3a764000080c080a0ef0de6c7b46fc75dd6cb86dccc3cfd731c2bdf6f3d736557240c3646c6fe01a6a07cd60b58dfe01847249dfdd7950ba0d045dded5bbe410b07a015a0ed34e5e00d
        annotatedTransaction:
          type: object
          description: Human-readable breakdown of the transaction for display purposes
          nullable: true
          example:
            method: stake
            inputs:
              amount: '1000000000000000000'
        structuredTransaction:
          type: object
          description: Detailed transaction data for client-side validation or simulation
          nullable: true
        stepIndex:
          type: number
          description: Zero-based index of the step in the action flow
          example: 0
        description:
          type: string
          description: User-friendly description of what this transaction does
          example: Approve USDC for staking
        error:
          type: string
          description: Error message if the transaction failed
          nullable: true
        gasEstimate:
          type: string
          description: Estimated gas cost for the transaction
          example: '21000'
        explorerUrl:
          type: string
          description: Link to the blockchain explorer for this transaction
          nullable: true
          example: https://etherscan.io/tx/0x1234...
        isMessage:
          type: boolean
          description: Whether this transaction is a message rather than a value transfer
          example: false
      required:
        - id
        - title
        - network
        - status
        - type
        - hash
        - createdAt
        - broadcastedAt
        - signedTransaction
        - unsignedTransaction
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: x-api-key

````