# Partners API Integration

This section outlines Neby's public API endpoints designed to support partners, integrators, and developers who need to access reliable data on DEX activity—specifically swaps and cross-chain bridge transactions.

These endpoints offer a straightforward way to monitor transactional activity on Neby without the need to query the subgraph directly. They are ideal for analytics platforms, token partners, ecosystem dashboards, and infrastructure providers who require up-to-date information for operational or monitoring purposes.

## Returns a list of bridge transactions.

> Retrieves bridge transactions with optional filtering by timestamp and pagination parameters.

```json
{"openapi":"3.1.0","info":{"title":"Neby Integration API","version":"1.0.0"},"servers":[{"url":"https://integration.api.neby.exchange","description":"Production server"}],"paths":{"/bridge":{"get":{"summary":"Returns a list of bridge transactions.","description":"Retrieves bridge transactions with optional filtering by timestamp and pagination parameters.","parameters":[{"name":"Accept","in":"header","description":"Specifies the expected response format","required":true,"schema":{"type":"string","default":"application/json"}},{"name":"startTimestamp","in":"query","description":"Filter transactions after this Unix timestamp","required":false,"schema":{"type":"integer","default":0}},{"name":"limit","in":"query","description":"Maximum number of transactions to return","required":false,"schema":{"type":"integer","default":1000}},{"name":"address","in":"query","description":"Filter by user address (sender address)","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"A list of bridge transactions","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"type":"object","properties":{"startTimestamp":{"type":"integer","description":"The start timestamp used for filtering"},"limit":{"type":"integer","description":"The limit parameter used"},"total":{"type":"integer","description":"Total number of transactions returned"},"address":{"type":"string","description":"The sender address used for filtering"}}},"data":{"type":"array","items":{"type":"object","properties":{"srcChainId":{"type":"string","description":"Source chain ID"},"srcTimestamp":{"type":"integer","description":"Unix timestamp on the source chain"},"srcTxHash":{"type":"string","description":"Transaction hash on the source chain"},"srcAddress":{"type":"string","description":"Source address"},"srcAmount":{"type":"string","description":"Amount on the source chain"},"destChainId":{"type":"string","description":"Destination chain ID"},"destTimestamp":{"type":"integer","description":"Unix timestamp on the destination chain"},"destTxHash":{"type":"string","description":"Transaction hash on the destination chain"},"destAmount":{"type":"string","description":"Amount on the destination chain"},"destAddress":{"type":"string","description":"Destination address"},"status":{"type":"string","description":"Status of the bridge transaction"},"depositId":{"type":"string","description":"Deposit ID"},"usdcValue":{"type":"string","description":"USDC value of the transaction"},"srcSymbol":{"type":"string","description":"Symbol of the source token"},"recipientAddress":{"type":"string","description":"Address of the recipient"},"senderAddress":{"type":"string","description":"Address of the sender"}}}}}}}}}}}}}}
```

## Returns a list of swap transactions.

> Retrieves swap transactions with optional filtering by timestamp, token addresses, and pagination parameters. There is 15 minute delay between api and onchain actions.

```json
{"openapi":"3.1.0","info":{"title":"Neby Integration API","version":"1.0.0"},"servers":[{"url":"https://integration.api.neby.exchange","description":"Production server"}],"paths":{"/swaps":{"get":{"summary":"Returns a list of swap transactions.","description":"Retrieves swap transactions with optional filtering by timestamp, token addresses, and pagination parameters. There is 15 minute delay between api and onchain actions.","parameters":[{"name":"Accept","in":"header","description":"Specifies the expected response format","required":true,"schema":{"type":"string","default":"application/json"}},{"name":"startTimestamp","in":"query","description":"Filter transactions after this Unix timestamp","required":false,"schema":{"type":"integer","default":0}},{"name":"order","in":"query","description":"Sort order for transactions","required":false,"schema":{"type":"string","enum":["asc","desc"],"default":"desc"}},{"name":"limit","in":"query","description":"Maximum number of transactions to return","required":false,"schema":{"type":"integer","default":1000}},{"name":"offset","in":"query","description":"Number of transactions to skip","required":false,"schema":{"type":"integer","default":0}},{"name":"tokenAddressIn","in":"query","description":"Filter by input token address","required":true,"schema":{"type":"string","format":"string"}},{"name":"tokenAddressOut","in":"query","description":"Filter by output token address","required":true,"schema":{"type":"string"}},{"name":"address","in":"query","description":"Filter by user address","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"A list of swap transactions","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"type":"object","properties":{"startTimestamp":{"type":"integer","description":"The start timestamp used for filtering"},"limit":{"type":"integer","description":"The limit parameter used"},"offset":{"type":"integer","description":"The offset parameter used"},"order":{"type":"string","description":"The sort order used"},"total":{"type":"integer","description":"Total number of transactions returned"},"address":{"type":"string","description":"The address used for filtering"}}},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the swap"},"timestamp":{"type":"integer","description":"Unix timestamp of the swap"},"blockNumber":{"type":"integer","description":"Block number of the transaction"},"tokenInSymbol":{"type":"string","description":"Symbol of the input token"},"tokenInAddress":{"type":"string","description":"Address of the input token"},"tokenOutSymbol":{"type":"string","description":"Symbol of the output token"},"tokenOutAddress":{"type":"string","description":"Address of the output token"},"sender":{"type":"string","description":"Address of the sender"},"amountIn":{"type":"string","description":"Amount of input token"},"amountOut":{"type":"string","description":"Amount of output token"}}}}}}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://neby.gitbook.io/neby-documentation/ecosystem/partners-api-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.