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
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
GET /swaps 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"
    }
  ]
}
PreviousSubgraphs and Addresses

Last updated