> For the complete documentation index, see [llms.txt](https://neby.gitbook.io/neby-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://neby.gitbook.io/neby-documentation/ecosystem/partners-api-integration.md).

# 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"}}}}}}}}}}}}}}
```