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

# Get Transaction History

> Retrieve transaction history for a wallet

### Authorization

<ParamField header="Authorization" type="string" required>
  Bearer token. Format: `Bearer bookie_live_abc123def456`
</ParamField>

### Path Parameters

<ParamField path="walletAddress" type="string" required>
  Solana wallet address. Format: Base58 encoded public key
</ParamField>

### Query Parameters

<ParamField query="limit" type="number" default="50">
  Maximum number of transactions to return. Max: 100
</ParamField>

<ParamField query="before" type="string">
  Transaction signature to paginate before
</ParamField>

<ParamField query="type" type="string">
  Filter by transaction type. Options: `swap`, `transfer`, `all`
</ParamField>

### Response

<ResponseField name="data" type="array">
  Array of transaction objects

  Each transaction contains:

  * `signature` (string): Transaction signature
  * `type` (string): Transaction type
  * `timestamp` (string): ISO 8601 timestamp
  * `status` (string): Transaction status
  * `details` (object): Type-specific details
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata

  Properties:

  * `hasMore` (boolean): Whether more transactions exist
  * `before` (string): Signature for next page
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.bookie.app/v1/transactions/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU?limit=20' \
    --header 'Authorization: Bearer bookie_live_abc123def456'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://api.bookie.app/v1/transactions/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU?limit=20',
    {
      headers: {
        'Authorization': `Bearer ${process.env.BOOKIE_API_KEY}`
      }
    }
  );
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.bookie.app/v1/transactions/7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
      headers={
          'Authorization': f'Bearer {api_key}'
      },
      params={
          'limit': 20
      }
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "data": [
      {
        "signature": "5wHu1qwD...",
        "type": "swap",
        "timestamp": "2024-03-08T14:30:00Z",
        "status": "confirmed",
        "details": {
          "inputToken": "SOL",
          "outputToken": "USDC",
          "inputAmount": 5.0,
          "outputAmount": 736.25,
          "priceImpact": 0.12
        }
      },
      {
        "signature": "3kJd9sLp...",
        "type": "transfer",
        "timestamp": "2024-03-08T13:15:00Z",
        "status": "confirmed",
        "details": {
          "token": "USDC",
          "amount": 10.0,
          "recipient": "alice.sol"
        }
      }
    ],
    "pagination": {
      "hasMore": true,
      "before": "3kJd9sLp..."
    }
  }
  ```
</ResponseExample>
