openapi: 3.0.3
info:
  title: Clawdia Agent Gateway Agent Infrastructure Crypto Prices API
  description: 'Unified API gateway providing 40+ services for AI agents. Web scraping, screenshots, code execution, crypto data, agent memory, file storage, and more.


    **Authentication**: Free tier (200 credits, no key needed). For higher volume: create an API key via `POST /api/keys/create`, then pass it as `X-API-Key` header or `?key=` query param.


    **x402 Payments**: All endpoints support [x402](https://www.x402.org/) micropayments (USDC on Base). Send a request without auth to get a 402 response with payment details.'
  version: 1.0.0
  contact:
    name: Clawdia
    url: https://api-catalog-three.vercel.app
  license:
    name: MIT
servers:
- url: https://agent-gateway-kappa.vercel.app
  description: Production gateway
security:
- {}
- ApiKeyHeader: []
- ApiKeyQuery: []
tags:
- name: Crypto Prices
  description: Real-time cryptocurrency price endpoints
paths:
  /v1/crypto-feeds/api/prices:
    get:
      summary: Get All Cryptocurrency Prices
      description: Returns real-time prices for 38+ cryptocurrency trading pairs including BTC, ETH, SOL, XRP, and more. Data sourced from Binance with 24h OHLCV data.
      operationId: getAllPrices
      tags:
      - Crypto Prices
      responses:
        '200':
          description: All cryptocurrency prices
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PricesResponse'
              example:
                count: 38
                prices:
                  BTCUSDT:
                    symbol: BTCUSDT
                    price: 71103.4
                    open: 73228
                    high: 73565.2
                    low: 70647.1
                    volume: 11622.15
                    quote_volume: 838255962.02
                    change: -2124.6
                    change_pct: -2.9
                    timestamp: 1772746736407
  /v1/defi-trading/api/markets:
    get:
      summary: Get Market Data
      description: Returns market data including available trading pairs and current prices.
      operationId: getMarkets
      tags:
      - Crypto Prices
      responses:
        '200':
          description: Market data
          content:
            application/json:
              schema:
                type: object
                properties:
                  markets:
                    type: array
                    items:
                      type: object
                      properties:
                        symbol:
                          type: string
                        price:
                          type: number
                        change_pct:
                          type: number
  /api/prices:
    get:
      summary: Get Prices (shortcut Endpoint)
      description: Shortcut endpoint that returns cryptocurrency prices directly.
      operationId: getPricesShortcut
      tags:
      - Crypto Prices
      security: []
      responses:
        '200':
          description: Cryptocurrency prices
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PricesResponse'
components:
  schemas:
    PriceData:
      type: object
      properties:
        symbol:
          type: string
          example: BTCUSDT
        price:
          type: number
          format: double
          description: Current price in USD
          example: 71103.4
        open:
          type: number
          description: 24h opening price
        high:
          type: number
          description: 24h high price
        low:
          type: number
          description: 24h low price
        volume:
          type: number
          description: 24h trading volume in base currency
        quote_volume:
          type: number
          description: 24h trading volume in quote currency (USD)
        change:
          type: number
          description: 24h price change in USD
        change_pct:
          type: number
          description: 24h price change percentage
        bid:
          type: number
          nullable: true
          description: Current best bid price
        ask:
          type: number
          nullable: true
          description: Current best ask price
        timestamp:
          type: integer
          format: int64
          description: Unix timestamp in milliseconds
    PricesResponse:
      type: object
      properties:
        count:
          type: integer
          description: Number of trading pairs
          example: 38
        prices:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/PriceData'
  securitySchemes:
    ApiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key passed in header
    ApiKeyQuery:
      type: apiKey
      in: query
      name: key
      description: API key passed as query parameter