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.

get

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

Query parameters

startTimestampintegerOptional

Filter transactions after this Unix timestamp

Default: 0

limitintegerOptional

Maximum number of transactions to return

Default: 1000

addressstringOptional

Filter by user address (sender address)

Example: 0xb01de4175a8ca5367c73c320dee71cb69b6b6bc2

Header parameters

AcceptstringRequired

Specifies the expected response format

Default: application/json

Responses

200

A list of bridge transactions

application/json

get

/bridge

HTTPcURLJavaScriptPython

GET /bridge HTTP/1.1
Host: integration.api.neby.exchange
Accept: application/json

200

A list of bridge transactions

{
  "meta": {
    "startTimestamp": 0,
    "limit": 1,
    "total": 1,
    "address": "0xB01de4175A8cA5367C73c320deE71cb69b6b6bC2"
  },
  "data": [
    {
      "srcChainId": "1",
      "srcTimestamp": 1733401007,
      "srcTxHash": "0x645127abafb3ff2d166b2ed38aa5b327652639273877ca34d3760bcf4b598785",
      "srcAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
      "srcAmount": "0.001",
      "destChainId": "23294",
      "destTimestamp": 1733401105,
      "destTxHash": "0xe04e9ef6c6e8caa943bc6268d572eb34b93b93cf260902de3aff477112b12113",
      "destAmount": "0.000971789927757929",
      "destAddress": "0xB6dc6C8b71e88642cEAD3be1025565A9eE74d1C6",
      "status": "completed",
      "depositId": "357",
      "usdcValue": "3.830022455",
      "srcSymbol": "ETH",
      "destSymbol": "ETH",
      "recipientAddress": "0xb01de4175a8ca5367c73c320dee71cb69b6b6bc2",
      "senderAddress": "0xB01de4175A8cA5367C73c320deE71cb69b6b6bC2"
    }
  ]
}

Returns a list of swap transactions.

get

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

Query parameters

startTimestampintegerOptional

Filter transactions after this Unix timestamp

Default: 0

orderstring · enumOptional

Sort order for transactions

Default: descPossible values:

limitintegerOptional

Maximum number of transactions to return

Default: 1000

offsetintegerOptional

Number of transactions to skip

Default: 0

tokenAddressInstring · stringRequired

Filter by input token address

Example: 0x8Bc2B030b299964eEfb5e1e0b36991352E56D2D3

tokenAddressOutstringRequired

Filter by output token address

Example: 0xDD629E5241CbC5919847783e6C96B2De4754e438

addressstringOptional

Filter by user address

Header parameters

AcceptstringRequired

Specifies the expected response format

Default: application/json

Responses

200

A list of swap transactions

application/json

get

/swaps

HTTPcURLJavaScriptPython

GET /swaps?tokenAddressIn=text&tokenAddressOut=text HTTP/1.1
Host: integration.api.neby.exchange
Accept: application/json

200

A list of swap transactions

{
  "meta": {
    "startTimestamp": 0,
    "limit": 1,
    "offset": 0,
    "order": "desc",
    "total": 1
  },
  "data": [
    {
      "id": "0x96e453f86289bb8c18792d42c3cd006bec20150fa6ffd2f2b4fb78307bf5dde6",
      "timestamp": 1750783371,
      "blockNumber": 9444586,
      "tokenInSymbol": "wROSE",
      "tokenInAddress": "0x8bc2b030b299964eefb5e1e0b36991352e56d2d3",
      "tokenOutSymbol": "mTBILL",
      "tokenOutAddress": "0xdd629e5241cbc5919847783e6c96b2de4754e438",
      "sender": "0xeb7a585660df39985f512f67e7c077c4d92267f0",
      "amountIn": "1",
      "amountOut": "0.023338092293361523"
    }
  ]
}