Pagination

Yuzu's API takes a simple approach to pagination, using simple offset/limit parameters in requests to paginate through long lists of data.

The specific pagination paremeters will depend on whether the data you're pulling is timeseries data or not.

Typical pagination params for timeseries data look like the following:

Pagination params look a bit different, more akin to paginating a SQL query

Most resources enforce a max limit of 500 unless othewise specified. Refer to the schema reference for specific resources.

A common use case is listing all of the crypto trading pairs supported by the API. You would accomplish this by making a request like the following:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

query ListPairs($offset: Int) {
  cryptoTradingPairs(input: { limit: 500, offset: $offset }) {
    id
    symbol
    quoteAsset {
      __typename
      ...on Currency {
        symbol
      }
      ...on CryptoAsset {
        symbol
      }
    }
    baseAsset {
      symbol
    }
  }
}

On the first request, your variables would look like:

1

{ "variables": { "offset": 0 } }

After processing the results, if there are 500 items, you can make another request to get the next 500 by setting "offset": 500.