AMM

Endpoints to fetch historical AMM data. For all AMM endpoints, the step size between data points is calculated automatically based on the requested number of samples (default = 11_000 max), with a minimum step size being 20 seconds. Thus the maximum queryable duration to still get a 20 second step size is about 220,000 seconds (approximately 2.54 days).

get

Fetch the AMM's position (inventory) over a specified time period.

Query parameters

marketNamestringRequired

The name of the market to get position data for (e.g., SOL-PERP)

Example: SOL-PERP

startinteger · int64Required

Start timestamp in seconds (must be less than end timestamp)

endinteger · int64Required

End timestamp in seconds (must be greater than start timestamp)

samplesinteger · max: 11000Optional

Number of data points to return. The API will automatically calculate the appropriate step size between points. Maximum value is 11,000.

Default: 11000

Responses

200

AMM position data

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/amm/position

HTTPcURLJavaScriptPython

GET /amm/position?marketName=SOL-PERP&start=1&end=1 HTTP/1.1
Host: 
Accept: */*

{
  "success": true,
  "data": [
    [
      1744173151,
      "7512.174273741"
    ],
    [
      1744777951,
      "-2396.800914929"
    ]
  ]
}

get

Fetch the AMM's bid and ask prices over a specified time period.

Query parameters

marketNamestringRequired

The name of the market to get bid-ask price data for (e.g., SOL-PERP)

Example: SOL-PERP

startinteger · int64Required

Start timestamp in seconds (must be less than end timestamp)

endinteger · int64Required

End timestamp in seconds (must be greater than start timestamp)

samplesinteger · max: 11000Optional

Number of data points to return. The API will automatically calculate the appropriate step size between points. Maximum value is 11,000.

Default: 11000

Responses

200

AMM bid-ask price data

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/amm/bidAskPrice

HTTPcURLJavaScriptPython

GET /amm/bidAskPrice?marketName=SOL-PERP&start=1&end=1 HTTP/1.1
Host: 
Accept: */*

{
  "success": true,
  "data": [
    [
      1744173151,
      "121.54",
      "122.87"
    ],
    [
      1744777951,
      "123.45",
      "124.56"
    ]
  ]
}

get

Fetch the oracle price data for a market over a specified time period.

Query parameters

marketNamestringRequired

The name of the market to get oracle price data for (e.g., SOL-PERP)

Example: SOL-PERP

startinteger · int64Required

Start timestamp in seconds (must be less than end timestamp)

endinteger · int64Required

End timestamp in seconds (must be greater than start timestamp)

samplesinteger · max: 11000Optional

Number of data points to return. The API will automatically calculate the appropriate step size between points. Maximum value is 11,000.

Default: 11000

Responses

200

Oracle price data

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/amm/oraclePrice

HTTPcURLJavaScriptPython

GET /amm/oraclePrice?marketName=SOL-PERP&start=1&end=1 HTTP/1.1
Host: 
Accept: */*

{
  "success": true,
  "data": [
    [
      1744173151,
      "122.15"
    ],
    [
      1744777951,
      "123.98"
    ]
  ]
}

get

Fetch the long and short spread data for an AMM over a specified time period.

Query parameters

marketNamestringRequired

The name of the market to get spread data for (e.g., SOL-PERP)

Example: SOL-PERP

startinteger · int64Required

Start timestamp in seconds (must be less than end timestamp)

endinteger · int64Required

End timestamp in seconds (must be greater than start timestamp)

samplesinteger · max: 11000Optional

Number of data points to return. The API will automatically calculate the appropriate step size between points. Maximum value is 11,000.

Default: 11000

Responses

200

AMM spread data

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/amm/spreads

HTTPcURLJavaScriptPython

GET /amm/spreads?marketName=SOL-PERP&start=1&end=1 HTTP/1.1
Host: 
Accept: */*

{
  "success": true,
  "data": [
    [
      1744173151,
      "0.05",
      "0.06"
    ],
    [
      1744777951,
      "0.04",
      "0.05"
    ]
  ]
}

get

Fetch the open interest data for a market over a specified time period.

Query parameters

marketNamestringRequired

The name of the market to get open interest data for (e.g., SOL-PERP)

Example: SOL-PERP

startinteger · int64Required

Start timestamp in seconds (must be less than end timestamp)

endinteger · int64Required

End timestamp in seconds (must be greater than start timestamp)

samplesinteger · max: 11000Optional

Number of data points to return. The API will automatically calculate the appropriate step size between points. Maximum value is 11,000.

Default: 11000

Responses

200

Open interest data

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/amm/openInterest

HTTPcURLJavaScriptPython

GET /amm/openInterest?marketName=SOL-PERP&start=1&end=1 HTTP/1.1
Host: 
Accept: */*

{
  "success": true,
  "data": [
    [
      1744173151,
      "1250000.45"
    ],
    [
      1744777951,
      "1345721.87"
    ]
  ]
}