> For the complete documentation index, see [llms.txt](https://docs.sigrex.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sigrex.io/api-reference/reference/signal-bots/dex-bot.md).

# DEX Bot

## GET /api/v2/bot/signal/dex

> Get all DEX signal bots

```json
{"openapi":"3.0.0","info":{"title":"Sigrex API","version":"2.1.0"},"tags":[{"name":"dex-bot"}],"servers":[{"url":"https://api.sigrex.io"}],"security":[{"ApiKey":[],"Signature":[],"Timestamp":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"api-key","description":"Your public API key"}},"schemas":{}},"paths":{"/api/v2/bot/signal/dex":{"get":{"summary":"Get all DEX signal bots","tags":["dex-bot"],"responses":{"200":{"description":"List of user's DEX signal bots","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DexSignalBot"}}}}}}}}}}
```

## POST /api/v2/bot/signal/dex

> Create a new DEX signal bot

```json
{"openapi":"3.0.0","info":{"title":"Sigrex API","version":"2.1.0"},"tags":[{"name":"dex-bot"}],"servers":[{"url":"https://api.sigrex.io"}],"security":[{"ApiKey":[],"Signature":[],"Timestamp":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"api-key","description":"Your public API key"}},"schemas":{"CreateDexSignalBotRequest":{"type":"object","required":["webhook_id","factory_id","chain_id","symbol","address"],"properties":{"name":{"type":"string","description":"The name of the bot max 255 characters"},"folder_id":{"type":"number","description":"The folder id of the bot"},"webhook_id":{"type":"number","description":"The id of a bot webhook"},"factory_id":{"type":"number","description":"The id of a bot factory"},"chain_id":{"type":"number","description":"The id of a chain"},"address":{"type":"string","description":"The address of the bot"},"symbol":{"type":"string","description":"The symbol of the bot"},"delay":{"type":"number","description":"Set how often the bot will check for new signals. eg. 10 means 10 in 1 second"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/api/v2/bot/signal/dex":{"post":{"summary":"Create a new DEX signal bot","tags":["dex-bot"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDexSignalBotRequest"}}}},"responses":{"201":{"description":"DEX signal bot created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DexSignalBot"}}}},"400":{"description":"Missing parameters, invalid data, or invalid contract address","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Factory or webhook not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## GET /api/v2/bot/signal/dex/total

> Get the total number of DEX signal bots

```json
{"openapi":"3.0.0","info":{"title":"Sigrex API","version":"2.1.0"},"tags":[{"name":"dex-bot"}],"servers":[{"url":"https://api.sigrex.io"}],"security":[{"ApiKey":[],"Signature":[],"Timestamp":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"api-key","description":"Your public API key"}}},"paths":{"/api/v2/bot/signal/dex/total":{"get":{"summary":"Get the total number of DEX signal bots","tags":["dex-bot"],"responses":{"200":{"description":"Total number of DEX signal bots","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"number"}}}}}}}}}}}
```

## GET /api/v2/bot/signal/dex/{id}

> Get DEX signal bot by ID

```json
{"openapi":"3.0.0","info":{"title":"Sigrex API","version":"2.1.0"},"tags":[{"name":"dex-bot"}],"servers":[{"url":"https://api.sigrex.io"}],"security":[{"ApiKey":[],"Signature":[],"Timestamp":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"api-key","description":"Your public API key"}},"schemas":{"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/api/v2/bot/signal/dex/{id}":{"get":{"summary":"Get DEX signal bot by ID","tags":["dex-bot"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"DEX signal bot details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DexSignalBot"}}}},"400":{"description":"Missing bot id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bot not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## PUT /api/v2/bot/signal/dex/{id}

> Update DEX signal bot

```json
{"openapi":"3.0.0","info":{"title":"Sigrex API","version":"2.1.0"},"tags":[{"name":"dex-bot"}],"servers":[{"url":"https://api.sigrex.io"}],"security":[{"ApiKey":[],"Signature":[],"Timestamp":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"api-key","description":"Your public API key"}},"schemas":{"UpdateDexSignalBotRequest":{"type":"object","required":["webhook_id","symbol"],"properties":{"name":{"type":"string","description":"The name of the bot max 255 characters"},"folder_id":{"type":"number","description":"The folder id of the bot"},"webhook_id":{"type":"number","description":"The id of a bot webhook"},"symbol":{"type":"string","description":"The symbol of the bot"},"delay":{"type":"number","description":"Set how often the bot will check for new signals. eg. 10 means 10 in 1 second"}}},"SuccessResponse":{"type":"object","properties":{"message":{"type":"string"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/api/v2/bot/signal/dex/{id}":{"put":{"summary":"Update DEX signal bot","tags":["dex-bot"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDexSignalBotRequest"}}}},"responses":{"200":{"description":"DEX signal bot updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"Missing bot id or invalid data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bot or webhook not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## DELETE /api/v2/bot/signal/dex/{id}

> Delete DEX signal bot

```json
{"openapi":"3.0.0","info":{"title":"Sigrex API","version":"2.1.0"},"tags":[{"name":"dex-bot"}],"servers":[{"url":"https://api.sigrex.io"}],"security":[{"ApiKey":[],"Signature":[],"Timestamp":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"api-key","description":"Your public API key"}},"schemas":{"SuccessResponse":{"type":"object","properties":{"message":{"type":"string"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/api/v2/bot/signal/dex/{id}":{"delete":{"summary":"Delete DEX signal bot","tags":["dex-bot"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"DEX signal bot deleted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"Missing bot id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bot not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## GET /api/v2/bot/signal/dex/{chainId}/{address}

> Get DEX signal bot by chain and address

```json
{"openapi":"3.0.0","info":{"title":"Sigrex API","version":"2.1.0"},"tags":[{"name":"dex-bot"}],"servers":[{"url":"https://api.sigrex.io"}],"security":[{"ApiKey":[],"Signature":[],"Timestamp":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"api-key","description":"Your public API key"}},"schemas":{"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/api/v2/bot/signal/dex/{chainId}/{address}":{"get":{"summary":"Get DEX signal bot by chain and address","tags":["dex-bot"],"parameters":[{"in":"path","name":"chainId","required":true,"schema":{"type":"string"}},{"in":"path","name":"address","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"DEX signal bot details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DexSignalBot"}}}},"400":{"description":"Missing chain id or address","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bot not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## GET /api/v2/bot/signal/dex/factory/{chainId}/{exchangeId}

> Get bot factory by chain and exchange

```json
{"openapi":"3.0.0","info":{"title":"Sigrex API","version":"2.1.0"},"tags":[{"name":"dex-bot"}],"servers":[{"url":"https://api.sigrex.io"}],"security":[{"ApiKey":[],"Signature":[],"Timestamp":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"api-key","description":"Your public API key"}},"schemas":{"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/api/v2/bot/signal/dex/factory/{chainId}/{exchangeId}":{"get":{"summary":"Get bot factory by chain and exchange","tags":["dex-bot"],"parameters":[{"in":"path","name":"chainId","required":true,"schema":{"type":"string"}},{"in":"path","name":"exchangeId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Factory details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotFactory"}}}},"400":{"description":"Missing chain or exchange","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Factory not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## PUT /api/v2/bot/signal/dex/{id}/status

> Update DEX signal bot status

```json
{"openapi":"3.0.0","info":{"title":"Sigrex API","version":"2.1.0"},"tags":[{"name":"dex-bot"}],"servers":[{"url":"https://api.sigrex.io"}],"security":[{"ApiKey":[],"Signature":[],"Timestamp":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"api-key","description":"Your public API key"}},"schemas":{"UpdateStatusRequest":{"type":"object","required":["status"],"properties":{"status":{"type":"string","enum":["ACTIVE","INACTIVE"]}}},"SuccessResponse":{"type":"object","properties":{"message":{"type":"string"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/api/v2/bot/signal/dex/{id}/status":{"put":{"summary":"Update DEX signal bot status","tags":["dex-bot"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateStatusRequest"}}}},"responses":{"200":{"description":"Status updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessResponse"}}}},"400":{"description":"Missing bot id, invalid status, or status already set","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"DEX bot limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bot not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.sigrex.io/api-reference/reference/signal-bots/dex-bot.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.