{
  "info": {
    "_postman_id": "cryptoprice-ai-agent-api-v1",
    "name": "CryptoPrice AI Agent API v1",
    "description": "AI-powered crypto assistant API with web search, image generation, chart analysis, and trading tools for CryptoPrice.pro platform.\n\n## Authentication\nAll endpoints require Bearer token authentication. Use your API key in the Authorization header.\n\n## Credit System\n1 Credit = 10 API Requests\n\n## Available MCP Tools\nEnable tools via the `mcpIds` parameter with `[\"service-tools\"]`.\n\n| Tool | Credits | Description |\n|------|---------|-------------|\n| `web_search` | 3 | Web search using OpenAI Search Preview API |\n| `generate_image` | 3 | AI image generation using Google Gemini |\n| `edit_image` | 3 | AI image editing using Google Gemini |\n| `service_crypto_price_converter` | 1 | Crypto price converter using Binance real-time data |\n| `service_image_chart_analysis` | 5 | AI chart technical analysis from screenshot |\n| `service_portfolio_screenshot_insights` | 5 | Portfolio screenshot analysis with AI evaluation |\n| `service_heatmap_screenshot_analysis` | 10 | Heatmap & liquidation map analysis with AI |\n| `service_candlestick_pattern_detector` | 10 | AI candlestick pattern detection from chart screenshot |\n| `service_support_resistance_zones` | 10 | AI support & resistance zone detection from chart screenshot |\n\n## Endpoints\n- POST /api/v1/agent - Create a new AI agent request\n- GET /api/v1/agent/{requestId} - Get request result\n\n## Request Options\n- `message` (required): The message to send\n- `language` (optional): Language code (en, es, tr, etc). Default: en\n- `mcpIds` (optional): Array of MCP tool IDs to enable. Use `[\"service-tools\"]` to enable all tools.\n- `messageHistory` (optional): Array of previous messages (max 5) for context\n- `fileUrl` (optional): URL or array of URLs of files (images or documents) to analyze/edit. Accepts a single string or an array of up to 10 URLs. File types are auto-detected from the URL extension or content-type header. Supported: images (jpg, jpeg, png, gif, webp, bmp, svg, avif), documents (pdf, doc, docx, txt, csv, xls, xlsx, ppt, pptx, md, rtf)",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{api_key}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://www.cryptoprice.pro",
      "type": "string"
    },
    {
      "key": "api_key",
      "value": "sk_your_api_key_here",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "General",
      "item": [
        {
          "name": "Ask a Question",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"What are the latest developments in cryptocurrency?\",\n  \"language\": \"en\"\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "Basic question without any tools enabled. The AI will respond using its built-in knowledge."
          },
          "response": []
        },
        {
          "name": "Follow-up with Message History",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"Can you explain more about that?\",\n  \"language\": \"en\",\n  \"messageHistory\": [\n    { \"role\": \"user\", \"content\": \"What is Bitcoin?\" },\n    { \"role\": \"assistant\", \"content\": \"Bitcoin is a decentralized digital currency...\" }\n  ]\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "Follow-up question using message history for context (max 5 messages)."
          },
          "response": []
        },
        {
          "name": "Analyze Image from URL",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"Analyze this image and describe what you see\",\n  \"language\": \"en\",\n  \"fileUrl\": \"https://example.com/photo.jpg\"\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "Analyze an image from a URL. The file type is auto-detected from the URL extension. Supported image formats: jpg, jpeg, png, gif, webp, bmp, svg, avif."
          },
          "response": []
        },
        {
          "name": "Analyze Document from URL",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"Summarize this document\",\n  \"language\": \"en\",\n  \"fileUrl\": \"https://example.com/report.pdf\"\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "Analyze a document from a URL. The file type is auto-detected from the URL extension or content-type header. Supported document formats: pdf, doc, docx, txt, csv, xls, xlsx, ppt, pptx, md, rtf."
          },
          "response": []
        },
        {
          "name": "Get Request Result",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/agent/:requestId",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent", ":requestId"],
              "variable": [
                {
                  "key": "requestId",
                  "value": "550e8400-e29b-41d4-a716-446655440000",
                  "description": "The UUID returned from POST request"
                }
              ]
            },
            "description": "Get the status and response for a specific request.\n\n**Response Statuses:**\n- `pending`: Request is queued\n- `processing`: AI is generating response\n- `completed`: Response is ready\n- `failed`: Request failed"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Web Search",
      "item": [
        {
          "name": "Web Search",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"What are the latest Bitcoin news today?\",\n  \"language\": \"en\",\n  \"mcpIds\": [\"service-tools\"]\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "Search the web for real-time information using OpenAI Search Preview API. Costs 3 credits per use. The AI automatically uses the `web_search` tool when the query requires up-to-date information."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Image Generation",
      "item": [
        {
          "name": "Generate Image",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"Generate a futuristic cryptocurrency trading dashboard illustration\",\n  \"language\": \"en\",\n  \"mcpIds\": [\"service-tools\"]\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "Generate an AI image using Google Gemini. Costs 3 credits per use. The AI uses the `generate_image` tool when the message requests visual content creation."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Image Editing",
      "item": [
        {
          "name": "Edit Image",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"Edit this image: add a Bitcoin logo in the top right corner\",\n  \"language\": \"en\",\n  \"mcpIds\": [\"service-tools\"],\n  \"fileUrl\": \"https://example.com/my-image.png\"\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "Edit an existing image using AI. Costs 3 credits per use. Provide the image via `fileUrl` (single URL string or array of URLs) and describe the edits in the message. The AI uses the `edit_image` tool. For multi-image compositing, pass an array of image URLs and reference them by number in the message."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Crypto Price Converter",
      "item": [
        {
          "name": "Convert Crypto Price",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"What is the current price of Bitcoin in USD?\",\n  \"language\": \"en\",\n  \"mcpIds\": [\"service-tools\"]\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "Get real-time crypto prices using Binance data. Costs 1 credit per use. Uses the `service_crypto_price_converter` tool. Supports conversion between crypto and fiat currencies."
          },
          "response": []
        },
        {
          "name": "Convert Between Cryptos",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"How much is 2.5 ETH worth in BTC right now?\",\n  \"language\": \"en\",\n  \"mcpIds\": [\"service-tools\"]\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "Convert between different cryptocurrencies using live Binance rates. Costs 1 credit per use."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Chart Analysis",
      "item": [
        {
          "name": "Analyze Chart Screenshot",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"Analyze this chart and provide a detailed technical analysis\",\n  \"language\": \"en\",\n  \"mcpIds\": [\"service-tools\"],\n  \"fileUrl\": \"https://example.com/btc-chart.png\"\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "AI-powered technical analysis from a chart screenshot. Costs 5 credits per use. Uses the `service_image_chart_analysis` tool. Upload any trading chart screenshot and receive detailed analysis including trends, indicators, and insights."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Portfolio Insights",
      "item": [
        {
          "name": "Analyze Portfolio Screenshot",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"Analyze my portfolio and provide insights on diversification and risk\",\n  \"language\": \"en\",\n  \"mcpIds\": [\"service-tools\"],\n  \"fileUrl\": \"https://example.com/my-portfolio.png\"\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "AI evaluation of a portfolio screenshot. Costs 5 credits per use. Uses the `service_portfolio_screenshot_insights` tool. Provides analysis of asset allocation, diversification, risk assessment, and optimization suggestions."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Heatmap Analysis",
      "item": [
        {
          "name": "Analyze Heatmap Screenshot",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"Analyze this heatmap and identify key market trends\",\n  \"language\": \"en\",\n  \"mcpIds\": [\"service-tools\"],\n  \"fileUrl\": \"https://example.com/crypto-heatmap.png\"\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "AI analysis of heatmap and liquidation maps. Costs 10 credits per use. Uses the `service_heatmap_screenshot_analysis` tool. Identifies market trends, sector performance, and liquidation zones from visual data."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Candlestick Pattern Detection",
      "item": [
        {
          "name": "Detect Candlestick Patterns",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"Detect candlestick patterns in this chart and explain their significance\",\n  \"language\": \"en\",\n  \"mcpIds\": [\"service-tools\"],\n  \"fileUrl\": \"https://example.com/candlestick-chart.png\"\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "AI candlestick pattern detection from chart screenshots. Costs 10 credits per use. Uses the `service_candlestick_pattern_detector` tool. Identifies patterns like doji, hammer, engulfing, and more with trading implications."
          },
          "response": []
        }
      ]
    },
    {
      "name": "Support & Resistance Zones",
      "item": [
        {
          "name": "Detect Support & Resistance Zones",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message\": \"Identify support and resistance zones from this chart\",\n  \"language\": \"en\",\n  \"mcpIds\": [\"service-tools\"],\n  \"fileUrl\": \"https://example.com/price-chart.png\"\n}"
            },
            "url": {
              "raw": "{{base_url}}/api/v1/agent",
              "host": ["{{base_url}}"],
              "path": ["api", "v1", "agent"]
            },
            "description": "AI support and resistance zone detection from chart screenshots. Costs 10 credits per use. Uses the `service_support_resistance_zones` tool. Identifies key price levels, zones of interest, and potential breakout/breakdown areas."
          },
          "response": []
        }
      ]
    }
  ]
}