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

# Fetch Wallet Signatures

> Fetches transaction signatures for a wallet with intelligent caching, pagination, and time filtering. Features 5-minute cache TTL, custom time windows (within 7 days), and efficient RPC batching. Returns lightweight signature data that can be enhanced with other endpoints.



## OpenAPI

````yaml /api-reference/openapi.json post /wallet/{address}/signatures
openapi: 3.0.3
info:
  title: Blockline MEV Analytics API
  description: >-
    Professional MEV analytics API for Solana. Analyze transaction context,
    detect front-running, identify sandwich attacks, and gain competitive
    intelligence on Solana MEV activity.
  version: 1.0.0
  contact:
    name: Blockline Support
    url: https://blockline.soltop.sh
servers:
  - url: https://api.soltop.sh
    description: Production API
security:
  - ApiKeyAuth: []
tags:
  - name: Trade Analysis
    description: Analyze MEV activity and transaction context
  - name: Transactions
    description: Transaction details and metadata
  - name: Wallets
    description: Wallet transaction history
  - name: Data Management
    description: Backfill and data operations
  - name: MEV Analysis
    description: >-
      Sandwich attack detection: scan wallets, check transactions, and profile
      attackers (async job queue)
  - name: Write Locks
    description: Account write lock contention and hot account analysis
paths:
  /wallet/{address}/signatures:
    post:
      tags:
        - Wallets
      summary: Fetch Wallet Signatures
      description: >-
        Fetches transaction signatures for a wallet with intelligent caching,
        pagination, and time filtering. Features 5-minute cache TTL, custom time
        windows (within 7 days), and efficient RPC batching. Returns lightweight
        signature data that can be enhanced with other endpoints.
      operationId: getWalletSignatures
      parameters:
        - name: address
          in: path
          required: true
          schema:
            type: string
            pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
          description: Wallet address (base58)
          example: FnmStvzQ27Pm4U8r3M6gPD7mnk6ST6HwraPsoNmYpump
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                limit:
                  type: integer
                  description: Signatures to return per page
                  default: 100
                  minimum: 1
                  maximum: 1000
                  example: 100
                before:
                  type: string
                  description: Signature to paginate from (for subsequent pages)
                  example: 3AQ8vVrkH5FAG1GV8Ak1rEUc7eKgNuRGEmpUT5TfixZ9...
                start_time:
                  type: integer
                  description: >-
                    Unix timestamp - start of time window (must be within 7
                    days)
                  example: 1729368000
                end_time:
                  type: integer
                  description: Unix timestamp - end of time window (must be within 7 days)
                  example: 1729371600
                hint_signature:
                  type: string
                  description: Signature to start RPC fetching from (optimization hint)
      responses:
        '200':
          description: Wallet signatures
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      signatures:
                        type: array
                        items:
                          type: object
                          properties:
                            signature:
                              type: string
                            slot:
                              type: integer
                            blockTime:
                              type: integer
                            success:
                              type: boolean
                      pagination:
                        type: object
                        properties:
                          has_more:
                            type: boolean
                          next_before:
                            type: string
                            description: Use as 'before' parameter for next page
                          returned:
                            type: integer
                          total_in_window:
                            type: integer
                          from_cache:
                            type: boolean
                      metadata:
                        type: object
                        properties:
                          time_window_hours:
                            type: integer
                            example: 168
                          time_window_start:
                            type: integer
                          time_window_end:
                            type: integer
                          wallet_address:
                            type: string
                          processing_time_ms:
                            type: integer
                          cache_key:
                            type: string
        '400':
          $ref: 8bfc2abc-1edb-488f-91c7-8ada8fb2fc2d
        '401':
          $ref: 02ca5649-c9d9-4a5e-8f26-a133d5c61cc5
        '403':
          $ref: 80776eac-c595-4f19-9646-9d6dc9a6cf2c
        '429':
          $ref: cfbde83c-0b04-46b0-b46a-c3a713982079
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        API Key authentication. Format: `sk_live_xxx` (production) or
        `sk_test_xxx` (testing). Obtain your API key from the [Blockline
        Dashboard](https://blockline.soltop.sh/dashboard/api-keys).

````