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

# Get transactions

> This endpoint retrieves the transactions associated with a specific address in a wallet.



## OpenAPI

````yaml get /v1/wallets/{walletId}/addresses/{addressId}/transactions
openapi: 3.0.3
info:
  title: Yiksi Pay Documentation
  description: >-
    The OpenAPI specification of the Yiksi Pay API that enables fintechs and
    developers to seamlessly integrate stablecoin deposits and payments into
    their products.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.yiksipay.com
security:
  - apiKey: []
tags:
  - name: Wallet
    description: >-
      Wallet Management System


      Comprehensive wallet management API for multi-blockchain operations. This
      system handles wallet creation, configuration, balance monitoring, and
      integration with various blockchain networks.


      Core Functionality:


      - Multi-blockchain wallet creation and management
          
      - Balance monitoring and asset tracking
          
      - Auto-settlement rule configuration
          
      - Address generation and management
          
      - Transaction monitoring and processing
  - name: Addresses
    description: >-
      Address Management System


      Comprehensive blockchain address management API for operations. This
      system handles address creation, validation, monitoring, and management
      across multiple blockchain networks.  


      Core Functionality:


      - Multi-blockchain address generation
          
      - Address validation and verification
          
      - Balance monitoring and tracking
          
      - Transaction history management
          
      - Address labeling and organization
          
      - Integration with wallet systems
          
      - Real-time address monitoring
  - name: Asset
  - name: Transactions
  - name: Withdraw
    description: >-
      The Withdraw feature allows you to programmatically withdraw stablecoins
      from your master wallet with ease
  - name: Signing
    description: >-
      Typed data signing service for secure transaction authorization. Supports
      all EIP-712 standards including EIP-3009 (TransferWithAuthorization) and
      EIP-2612 (Permit).
  - name: Swap
    description: >-
      The Swap feature enables users to exchange one stabelcoin asset for
      another across different blockchains. This feature provides a seamless way
      to convert between different stablecoins while maintaining security and
      compliance standards.
  - name: Auto Settlements
    description: >-
      Creates a new auto settlement rule for a wallet. Auto settlement
      automatically transfers/swap assets based on configured rules when certain
      conditions are met.


      Rules can be configured for:


      - Source blockchain and assets
          
      - Destination blockchain and asset
          
      - Amount ranges (min/max)
          
      - Slippage tolerance
          
  - name: Smart Contract
    description: >-
      This API provides endpoints for interacting with smart contracts on the
      blockchain. It allows for reading contract data, executing contract
      functions, and estimating network fees.
  - name: Beneficiaries
    description: >-
      This API allows you to create beneficiaries with automatic settlements to
      your external wallets on a periodic basis.


      Example frequencies: INSTANT, DAILY, WEEKLY, MONTHLY, YEARLY
  - name: AML
    description: >-
      The AML (Anti Money Laundering) API provides a quick way for you to check
      if an address is blacklisted or sanctioned
  - name: Asset Recovery
    description: >-
      Enables the recovery (salvage) of both native blockchain assets and tokens
      from a specified sender address to a recipient address. This feature
      supports emergency fund recovery and asset consolidation operations.
  - name: Miscellaneous
    description: >-
      The Miscellaneous API are supporting APIs that can be used to provide more
      details to other APIs.
  - name: Asset1
  - name: Blockchain
  - name: Webhooks
    description: >-
      Webhooks allow you to set up a notification system that can be used to
      receive updates on certain requests made to the Yiksi Pay API.  
        
      To see full list and instructions
      [https://docs.yiksipay.com/essentials/webhooks](https://docs.yiksipay.com/essentials/webhooks)


      ##
  - name: Deposit
  - name: Withdraw1
  - name: Swap1
paths:
  /v1/wallets/{walletId}/addresses/{addressId}/transactions:
    parameters:
      - name: walletId
        in: path
        required: true
        schema:
          type: string
          example: YOUR_WALLET_ID
      - name: addressId
        in: path
        required: true
        schema:
          type: string
          example: ADDRESS_ID
    get:
      tags:
        - Addresses
      summary: Get transactions
      description: >-
        This endpoint retrieves the transactions associated with a specific
        address in a wallet.
      operationId: getTransactions
      parameters:
        - name: id
          in: query
          schema:
            type: string
            example: caba52f2-950c-4d93-a92a-12032430e5b2
          description: The transaction ID
        - name: hash
          in: query
          schema:
            type: string
            example: '0x316750e68b7da65c3d03da3fd551a3a750a74e5c21ca2f8445f4ec2c4d07e91c'
          description: The transaction Hash
        - name: status
          in: query
          schema:
            type: string
            example: SUCCESS
          description: 'Transactions statuses.  Available values: PENDING, SUCCESS, FAILED'
        - name: type
          in: query
          schema:
            type: string
            example: DEPOSIT
          description: 'Transactions  Type.  Available values: DEPOSIT, WITHDRAW,SALVAGE'
        - name: order
          in: query
          schema:
            type: string
            example: DESC
          description: Order By. DESC, ASC
        - name: assets
          in: query
          schema:
            type: string
            example: USDT, USDC
          description: A list of assets to filter by, seperated by commas
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        address:
                          type: object
                          properties:
                            address:
                              type: string
                              example: '0x7DfCf25Ee202f0d564E2951bD4E487391D71F9D4'
                            configurations:
                              type: object
                              properties:
                                aml:
                                  type: object
                                  properties:
                                    message:
                                      type: string
                                      example: Address is not sanctioned
                                    provider:
                                      type: string
                                      example: ofac
                                    status:
                                      type: string
                                      example: success
                                disableAutoSweep:
                                  type: boolean
                                  example: false
                                enableGaslessWithdraw:
                                  type: boolean
                                  example: false
                                isActive:
                                  type: boolean
                                  example: false
                                showPrivateKey:
                                  type: boolean
                                  example: false
                            createdAt:
                              type: string
                              example: '2024-10-16T05:23:11.095Z'
                            derivationPath:
                              type: string
                              example: m/44'/60'/0'/0/85
                            id:
                              type: string
                              example: 87a25d98-f3c4-4521-8d31-e97b97be613f
                            isActive:
                              type: boolean
                              example: false
                            metadata:
                              nullable: true
                              example: null
                            name:
                              nullable: true
                              example: null
                            network:
                              type: string
                              example: testnet
                            type:
                              type: string
                              example: INTERNAL
                            updatedAt:
                              type: string
                              example: '2024-10-16T05:47:51.206Z'
                        amlScreening:
                          type: object
                          properties:
                            message:
                              type: string
                              example: Address is not sanctioned
                            provider:
                              type: string
                              example: ofac
                            status:
                              type: string
                              example: success
                        amount:
                          type: string
                          example: '1.0'
                        amountPaid:
                          type: string
                          example: '1.0'
                        asset:
                          type: object
                          properties:
                            address:
                              type: string
                              example: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd'
                            createdAt:
                              type: string
                              example: '2024-05-14T11:53:33.680Z'
                            decimals:
                              type: number
                              example: 18
                            id:
                              type: string
                              example: 1890db58-f624-4972-a72b-e25387a81520
                            isActive:
                              type: boolean
                              example: true
                            logoUrl:
                              type: string
                              example: >-
                                https://res.cloudinary.com/dkgdc1vnl/image/upload/v1771444993/crypto-assets/USDT.png
                            name:
                              type: string
                              example: Tether USD
                            network:
                              type: string
                              example: testnet
                            standard:
                              type: string
                              example: BEP20
                            symbol:
                              type: string
                              example: USDT
                            updatedAt:
                              type: string
                              example: '2024-06-14T22:36:43.868Z'
                        assetSwept:
                          type: boolean
                          example: true
                        assetSweptAmount:
                          type: string
                          example: '1.0'
                        assetSweptAt:
                          type: string
                          example: '2024-10-16T05:25:18.728Z'
                        assetSweptGasFee:
                          type: string
                          example: '0.00018817'
                        assetSweptHash:
                          type: string
                          example: >-
                            0xa82af9af98018f186ee4fc3b1e2c291f0590edc481a3caffa968dea554a45dfa
                        assetSweptRecipientAddress:
                          type: string
                          example: '0x947514e4B803e312C312da0F1B41fEDdbe15ae7a'
                        assetSweptSenderAddress:
                          type: string
                          example: '0x7DfCf25Ee202f0d564E2951bD4E487391D71F9D4'
                        blockHash:
                          type: string
                          example: >-
                            0x648228489993139fa100f6a11108779efe9b57cfcd377d926588476d78268b37
                        blockNumber:
                          type: number
                          example: 44778502
                        blockchain:
                          type: object
                          properties:
                            createdAt:
                              type: string
                              example: '2024-05-14T11:53:33.106Z'
                            derivationPath:
                              type: string
                              example: m/44'/60'/0'/0
                            id:
                              type: string
                              example: b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa
                            isActive:
                              type: boolean
                              example: true
                            isEvmCompatible:
                              type: boolean
                              example: true
                            logoUrl:
                              type: string
                              example: >-
                                https://res.cloudinary.com/dkgdc1vnl/image/upload/v1771445000/crypto-assets/bnb-smart-chain.png
                            name:
                              type: string
                              example: BNB smart chain
                            slug:
                              type: string
                              example: bnb-smart-chain
                            symbol:
                              type: string
                              example: bnb
                            tokenStandard:
                              type: string
                              example: BEP20
                            updatedAt:
                              type: string
                              example: '2024-06-14T22:36:43.716Z'
                        chainId:
                          type: number
                          example: 97
                        confirmations:
                          type: number
                          example: 7
                        confirmed:
                          type: boolean
                          example: true
                        createdAt:
                          type: string
                          example: '2024-10-16T05:24:11.171Z'
                        currency:
                          type: string
                          example: USD
                        fee:
                          nullable: true
                          example: null
                        gasFee:
                          type: string
                          example: '0.0002838165'
                        gasPrice:
                          type: string
                          example: '5500000000'
                        gasUsed:
                          type: string
                          example: '51603'
                        hash:
                          type: string
                          example: >-
                            0xa8637dbe4614184f91198f907b5266f0d70453974d7167d44b41955277816754
                        id:
                          type: string
                          example: 4c2cf0db-3ba3-422d-b973-02eaf1074781
                        metadata:
                          nullable: true
                          example: null
                        network:
                          type: string
                          example: testnet
                        note:
                          nullable: true
                          example: null
                        reason:
                          type: string
                          example: Funds swept successfully
                        recipientAddress:
                          type: string
                          example: '0x7DfCf25Ee202f0d564E2951bD4E487391D71F9D4'
                        reference:
                          type: string
                          example: aGEomQa4pj
                        senderAddress:
                          type: string
                          example: '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22'
                        status:
                          type: string
                          example: SUCCESS
                        type:
                          type: string
                          example: DEPOSIT
                        updatedAt:
                          type: string
                          example: '2024-10-16T05:25:18.741Z'
                    example:
                      - address:
                          address: '0x7DfCf25Ee202f0d564E2951bD4E487391D71F9D4'
                          configurations:
                            aml:
                              message: Address is not sanctioned
                              provider: ofac
                              status: success
                            disableAutoSweep: false
                            enableGaslessWithdraw: false
                            isActive: false
                            showPrivateKey: false
                          createdAt: '2024-10-16T05:23:11.095Z'
                          derivationPath: m/44'/60'/0'/0/85
                          id: 87a25d98-f3c4-4521-8d31-e97b97be613f
                          isActive: false
                          metadata: null
                          name: null
                          network: testnet
                          type: INTERNAL
                          updatedAt: '2024-10-16T05:47:51.206Z'
                        amlScreening:
                          message: Address is not sanctioned
                          provider: ofac
                          status: success
                        amount: '1.0'
                        amountPaid: '1.0'
                        asset:
                          address: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd'
                          createdAt: '2024-05-14T11:53:33.680Z'
                          decimals: 18
                          id: 1890db58-f624-4972-a72b-e25387a81520
                          isActive: true
                          logoUrl: >-
                            https://res.cloudinary.com/dkgdc1vnl/image/upload/v1771444993/crypto-assets/USDT.png
                          name: Tether USD
                          network: testnet
                          standard: BEP20
                          symbol: USDT
                          updatedAt: '2024-06-14T22:36:43.868Z'
                        assetSwept: true
                        assetSweptAmount: '1.0'
                        assetSweptAt: '2024-10-16T05:25:18.728Z'
                        assetSweptGasFee: '0.00018817'
                        assetSweptHash: >-
                          0xa82af9af98018f186ee4fc3b1e2c291f0590edc481a3caffa968dea554a45dfa
                        assetSweptRecipientAddress: '0x947514e4B803e312C312da0F1B41fEDdbe15ae7a'
                        assetSweptSenderAddress: '0x7DfCf25Ee202f0d564E2951bD4E487391D71F9D4'
                        blockHash: >-
                          0x648228489993139fa100f6a11108779efe9b57cfcd377d926588476d78268b37
                        blockNumber: 44778502
                        blockchain:
                          createdAt: '2024-05-14T11:53:33.106Z'
                          derivationPath: m/44'/60'/0'/0
                          id: b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa
                          isActive: true
                          isEvmCompatible: true
                          logoUrl: >-
                            https://res.cloudinary.com/dkgdc1vnl/image/upload/v1771445000/crypto-assets/bnb-smart-chain.png
                          name: BNB smart chain
                          slug: bnb-smart-chain
                          symbol: bnb
                          tokenStandard: BEP20
                          updatedAt: '2024-06-14T22:36:43.716Z'
                        chainId: 97
                        confirmations: 7
                        confirmed: true
                        createdAt: '2024-10-16T05:24:11.171Z'
                        currency: USD
                        fee: null
                        gasFee: '0.0002838165'
                        gasPrice: '5500000000'
                        gasUsed: '51603'
                        hash: >-
                          0xa8637dbe4614184f91198f907b5266f0d70453974d7167d44b41955277816754
                        id: 4c2cf0db-3ba3-422d-b973-02eaf1074781
                        metadata: null
                        network: testnet
                        note: null
                        reason: Funds swept successfully
                        recipientAddress: '0x7DfCf25Ee202f0d564E2951bD4E487391D71F9D4'
                        reference: aGEomQa4pj
                        senderAddress: '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22'
                        status: SUCCESS
                        type: DEPOSIT
                        updatedAt: '2024-10-16T05:25:18.741Z'
                  message:
                    type: string
                    example: Transactions fetched successfully
                  meta:
                    type: object
                    properties:
                      currentPage:
                        type: number
                        example: 1
                      itemCount:
                        type: number
                        example: 1
                      itemsPerPage:
                        type: number
                        example: 100
                      totalItems:
                        type: number
                        example: 1
                      totalPages:
                        type: number
                        example: 1
                  statusCode:
                    type: number
                    example: 200
              examples:
                '200':
                  value:
                    data:
                      - address:
                          address: '0x7DfCf25Ee202f0d564E2951bD4E487391D71F9D4'
                          configurations:
                            aml:
                              message: Address is not sanctioned
                              provider: ofac
                              status: success
                            disableAutoSweep: false
                            enableGaslessWithdraw: false
                            isActive: false
                            showPrivateKey: false
                          createdAt: '2024-10-16T05:23:11.095Z'
                          derivationPath: m/44'/60'/0'/0/85
                          id: 87a25d98-f3c4-4521-8d31-e97b97be613f
                          isActive: false
                          metadata: null
                          name: null
                          network: testnet
                          type: INTERNAL
                          updatedAt: '2024-10-16T05:47:51.206Z'
                        amlScreening:
                          message: Address is not sanctioned
                          provider: ofac
                          status: success
                        amount: '1.0'
                        amountPaid: '1.0'
                        asset:
                          address: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd'
                          createdAt: '2024-05-14T11:53:33.680Z'
                          decimals: 18
                          id: 1890db58-f624-4972-a72b-e25387a81520
                          isActive: true
                          logoUrl: >-
                            https://res.cloudinary.com/dkgdc1vnl/image/upload/v1771444993/crypto-assets/USDT.png
                          name: Tether USD
                          network: testnet
                          standard: BEP20
                          symbol: USDT
                          updatedAt: '2024-06-14T22:36:43.868Z'
                        assetSwept: true
                        assetSweptAmount: '1.0'
                        assetSweptAt: '2024-10-16T05:25:18.728Z'
                        assetSweptGasFee: '0.00018817'
                        assetSweptHash: >-
                          0xa82af9af98018f186ee4fc3b1e2c291f0590edc481a3caffa968dea554a45dfa
                        assetSweptRecipientAddress: '0x947514e4B803e312C312da0F1B41fEDdbe15ae7a'
                        assetSweptSenderAddress: '0x7DfCf25Ee202f0d564E2951bD4E487391D71F9D4'
                        blockHash: >-
                          0x648228489993139fa100f6a11108779efe9b57cfcd377d926588476d78268b37
                        blockNumber: 44778502
                        blockchain:
                          createdAt: '2024-05-14T11:53:33.106Z'
                          derivationPath: m/44'/60'/0'/0
                          id: b80d3d5e-16f1-4d99-be5e-6dfcd27f89aa
                          isActive: true
                          isEvmCompatible: true
                          logoUrl: >-
                            https://res.cloudinary.com/dkgdc1vnl/image/upload/v1771445000/crypto-assets/bnb-smart-chain.png
                          name: BNB smart chain
                          slug: bnb-smart-chain
                          symbol: bnb
                          tokenStandard: BEP20
                          updatedAt: '2024-06-14T22:36:43.716Z'
                        chainId: 97
                        confirmations: 7
                        confirmed: true
                        createdAt: '2024-10-16T05:24:11.171Z'
                        currency: USD
                        fee: null
                        gasFee: '0.0002838165'
                        gasPrice: '5500000000'
                        gasUsed: '51603'
                        hash: >-
                          0xa8637dbe4614184f91198f907b5266f0d70453974d7167d44b41955277816754
                        id: 4c2cf0db-3ba3-422d-b973-02eaf1074781
                        metadata: null
                        network: testnet
                        note: null
                        reason: Funds swept successfully
                        recipientAddress: '0x7DfCf25Ee202f0d564E2951bD4E487391D71F9D4'
                        reference: aGEomQa4pj
                        senderAddress: '0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22'
                        status: SUCCESS
                        type: DEPOSIT
                        updatedAt: '2024-10-16T05:25:18.741Z'
                    message: Transactions fetched successfully
                    meta:
                      currentPage: 1
                      itemCount: 1
                      itemsPerPage: 100
                      totalItems: 1
                      totalPages: 1
                    statusCode: 200
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````