Rubicon V2 Market API

The Rubicon V2 subgraph contains a collection of entities that collect and store data related to trading activity on the protocol's order books. Below are key entities that we believe user's will find most relevant to their data needs.

User Entity (ID: Wallet Address)

type User @entity {
    " the user address "
    id: Bytes!
    " map to all offers the user has created "
    offers: [Offer!]! @derivedFrom(field: "maker")
    " map to all takes the user has created "
    takes: [Take!]! @derivedFrom(field: "taker")
    " map to all swaps the user has created "
    swaps: [Swap!]! @derivedFrom(field: "swapper")
    " map to all fees the user has paid "
    fees_paid: [Fee!]! @derivedFrom(field: "user")
    " map to all fees the user has received "
    fees_received: [Fee!]! @derivedFrom(field: "recipient")
}

Offer Entity (ID: The Offer ID)

type Offer @entity {
    " the offer id "
    id: Bytes!
    " the transaction that the offer was created in "
    transaction: Transaction!
    " the timestamp of the transaction that the offer was created in "
    timestamp: BigInt!
    " the event log index of the offer "
    index: BigInt!
    " the maker of the offer "
    maker: User!
    " the pay token of the offer (the asset the maker is selling) "
    pay_gem: Bytes!
    " the buy token of the offer (the asset the maker is buying) "
    buy_gem: Bytes!
    " the amount of pay token the maker is selling "
    pay_amt: BigInt!
    " the amount of buy token the maker is buying "
    buy_amt: BigInt!
    " the amount of the pay token that the maker has already sold "
    paid_amt: BigInt!
    " the amount of the buy token that the maker has already bought "
    bought_amt: BigInt!
    " the price of the offer as a ratio of pay_gem / buy_gem "
    price: BigDecimal!
    " the status of the offer, is it live or not "
    open: Boolean!
    " the timestamp the offer was removed on "
    removed_timestamp: BigInt
    " the block the offer was removed in "
    removed_block: BigInt
}

Take Entity (ID: Transaction Hash - Log Index)

type Take @entity {
    " the transaction hash and log index of the take "
    id: Bytes!
    " the transaction that the take was a part of "
    transaction: Transaction!
    " the timestamp of the transaction that the take was a part of "
    timestamp: BigInt!
    " the event log index of the take "
    index: BigInt!
    " the user that took the offer "
    taker: User!
    " the user that originated the transaction that the take was a part of "
    from: User!
    " the offer that was taken "
    offer: Offer!
    " the pay token of the offer (the asset the maker is selling & the asset the taker is buying) "
    take_gem: Bytes!
    " the buy token of the offer (the asset the maker is buying & the asset the taker is paying in) "
    give_gem: Bytes!
    " the amount of pay token the taker is buying "
    take_amt: BigInt!
    " the amount of buy token the taker is paying in "
    give_amt: BigInt!
}

Swap Entity (ID: Transaction Hash - Log Index)

type Swap @entity {
    " the transaction hash and log index of the swap "
    id: Bytes!
    " the transaction that the swap was a part of "
    transaction: Transaction!
    " the timestamp of the transaction that the swap was a part of "
    timestamp: BigInt!
    " the event log index of the swap "
    index: BigInt!
    " the user that initiated the swap "
    swapper: User!
    " the input token of the swap "
    input_gem: Bytes!
    " the output token of the swap "
    output_gem: Bytes!
    " the amount of input token the swapper is swapping "
    input_amt: BigInt!
    " the amount of output token the swapper is receiving "
    output_amt: BigInt!
}