Spiko

Spiko Distributor investor contracts API

The Distributor investor contracts API from Spiko — 4 operation(s) for distributor investor contracts.

GitHub OpenAPI

Operations 5

GET /v0/distributor-investor-contracts/{id} Get distributor investor contract #
GET /v0/distributor-investor-contracts/investor Get distributor investor contract of investor #
POST /v0/distributor-investor-contracts Create a contract #
PUT /v0/distributor-investor-contracts Update a distributor investor contract #
GET /v0/distributor-investor-contracts/{distributorInvestorContractId}/paid-fees Get the fees paid for the given distributor investor contract #

Documentation

📖
Documentation
https://docs.spiko.io/developers/public_api/getting_started
📖
Documentation
https://docs.spiko.io/developers/investor_api/getting_started
📖
Documentation
https://docs.spiko.io/developers/distributor_api/getting_started

Specifications

⚙
OpenAPI
https://artifacts.apis.io/spiko/openapi/spiko-distributor-investor-contracts-api-openapi.yml

Other Resources

🔗
Sandbox
https://artifacts.apis.io/spiko/sandbox/spiko-sandbox.yml
🔗
Webhooks
https://artifacts.apis.io/spiko/asyncapi/spiko-distributor-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/spiko:spiko-distributor-investor-contracts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

spiko-distributor-investor-contracts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Spiko Distributor Distributor investor contracts API
  version: v0
  description: The Distributor API allows third parties like SaaS providers, fintechs or Web3 companies to distribute the Spiko Funds to their customers. With this API, you can programmatically manage investors, send subscription and redemption orders, and access real-time portfolio information.
servers:
- url: https://distributor-api.spiko.io
  description: Production Server
- url: https://distributor-api.preprod.spiko.io
  description: Pre-production Server
security: []
tags:
- name: Distributor investor contracts
paths:
  /v0/distributor-investor-contracts/{id}:
    get:
      tags:
      - Distributor investor contracts
      operationId: distributorInvestorContracts.getDistributorInvestorContract
      parameters:
      - name: id
        in: path
        schema:
          type: string
          description: a Universally Unique Identifier
          format: uuid
        required: true
        description: a Universally Unique Identifier
      security:
      - basicAuth: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                - id
                - distributorId
                - investorId
                - shareClassId
                - annualFee
                properties:
                  id:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  distributorId:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  investorId:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  shareClassId:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  annualFee:
                    type: string
                    title: annual fee
                    description: annual fee paid by the investor to the distributor, expressed as a yearly rate (e.g. "0.0025" for 0.25%)
                additionalProperties: false
        '400':
          description: The request did not match the expected schema
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HttpApiDecodeError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/Unauthorized'
                - $ref: '#/components/schemas/DistributorAuthenticationError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: NotFound
      description: Retrieve information about a distributor investor contract (investor, share class, annual fee).
      summary: Get distributor investor contract
  /v0/distributor-investor-contracts/investor:
    get:
      tags:
      - Distributor investor contracts
      operationId: distributorInvestorContracts.getDistributorInvestorContractOfInvestorAndShareClass
      parameters:
      - name: investorId
        in: query
        schema:
          type: string
          description: a Universally Unique Identifier
          format: uuid
        required: true
        description: a Universally Unique Identifier
      - name: shareClassId
        in: query
        schema:
          type: string
          description: a Universally Unique Identifier
          format: uuid
        required: true
        description: a Universally Unique Identifier
      security:
      - basicAuth: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                - id
                - distributorId
                - investorId
                - shareClassId
                - annualFee
                properties:
                  id:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  distributorId:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  investorId:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  shareClassId:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  annualFee:
                    type: string
                    title: annual fee
                    description: annual fee paid by the investor to the distributor, expressed as a yearly rate (e.g. "0.0025" for 0.25%)
                additionalProperties: false
        '400':
          description: The request did not match the expected schema
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HttpApiDecodeError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/Unauthorized'
                - $ref: '#/components/schemas/DistributorAuthenticationError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: NotFound
      description: Get a distributor investor contract informations of the given investor.
      summary: Get distributor investor contract of investor
  /v0/distributor-investor-contracts:
    post:
      tags:
      - Distributor investor contracts
      operationId: distributorInvestorContracts.createDistributorInvestorContract
      parameters: []
      security:
      - basicAuth: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                - id
                - distributorId
                - investorId
                - shareClassId
                - annualFee
                properties:
                  id:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  distributorId:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  investorId:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  shareClassId:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  annualFee:
                    type: string
                    title: annual fee
                    description: annual fee paid by the investor to the distributor, expressed as a yearly rate (e.g. "0.0025" for 0.25%)
                additionalProperties: false
        '400':
          description: The request did not match the expected schema
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HttpApiDecodeError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/Unauthorized'
                - $ref: '#/components/schemas/DistributorAuthenticationError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: NotFound
        '405':
          description: MethodNotAllowed
      description: Create a new contract that defines the annual fee paid by the investor to the distributor for a share class.
      summary: Create a contract
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - investorId
              - shareClassId
              - annualFee
              properties:
                investorId:
                  type: string
                  description: a Universally Unique Identifier
                  format: uuid
                shareClassId:
                  type: string
                  description: a Universally Unique Identifier
                  format: uuid
                annualFee:
                  type: string
                  title: annual fee
                  description: annual fee paid by the investor to the distributor, expressed as a yearly rate (e.g. "0.0025" for 0.25%)
              additionalProperties: false
        required: true
    put:
      tags:
      - Distributor investor contracts
      operationId: distributorInvestorContracts.updateDistributorInvestorContractFee
      parameters: []
      security:
      - basicAuth: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                - id
                - distributorId
                - investorId
                - shareClassId
                - annualFee
                properties:
                  id:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  distributorId:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  investorId:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  shareClassId:
                    type: string
                    description: a Universally Unique Identifier
                    format: uuid
                  annualFee:
                    type: string
                    title: annual fee
                    description: annual fee paid by the investor to the distributor, expressed as a yearly rate (e.g. "0.0025" for 0.25%)
                additionalProperties: false
        '400':
          description: The request did not match the expected schema
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HttpApiDecodeError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/Unauthorized'
                - $ref: '#/components/schemas/DistributorAuthenticationError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: NotFound
      description: Update the annual fee of an existing distributor investor contract.
      summary: Update a distributor investor contract
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - id
              - annualFee
              properties:
                id:
                  type: string
                  description: a Universally Unique Identifier
                  format: uuid
                annualFee:
                  type: string
                  title: annual fee
                  description: annual fee paid by the investor to the distributor, expressed as a yearly rate (e.g. "0.0025" for 0.25%)
              additionalProperties: false
        required: true
  /v0/distributor-investor-contracts/{distributorInvestorContractId}/paid-fees:
    get:
      tags:
      - Distributor investor contracts
      operationId: distributorInvestorContracts.getPaidFees
      parameters:
      - name: distributorInvestorContractId
        in: path
        schema:
          type: string
          description: a Universally Unique Identifier
          format: uuid
        required: true
        description: a Universally Unique Identifier
      - name: from
        in: query
        schema:
          type: string
          title: Day
          description: a day formatted as "yyyy-MM-dd"
        required: false
        description: a day formatted as "yyyy-MM-dd"
      - name: to
        in: query
        schema:
          type: string
          title: Day
          description: a day formatted as "yyyy-MM-dd"
        required: false
        description: a day formatted as "yyyy-MM-dd"
      security:
      - basicAuth: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  required:
                  - distributorInvestorContractId
                  - day
                  - paidFee
                  - paidFeeInShares
                  properties:
                    distributorInvestorContractId:
                      type: string
                      description: a Universally Unique Identifier
                      format: uuid
                    day:
                      type: string
                      title: Day
                      description: a day formatted as "yyyy-MM-dd"
                    paidFee:
                      $ref: '#/components/schemas/NonNegativeAmount'
                    paidFeeInShares:
                      type: string
                      title: non-negative decimal number as a string
                      description: a string representation of a non-negative decimal number e.g. "10000", "0.00" or "3420.92"
                  additionalProperties: false
        '400':
          description: The request did not match the expected schema
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HttpApiDecodeError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                anyOf:
                - $ref: '#/components/schemas/Unauthorized'
                - $ref: '#/components/schemas/DistributorAuthenticationError'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: NotFound
      description: '**Retrieve the fees paid for the given distributor investor contract.**


        - Returns an array of paid fees both in amount and in number of shares, sorted by day.

        - `from` and `to` query parameters are optional and used to filter the results by day range.'
      summary: Get the fees paid for the given distributor investor contract
components:
  schemas:
    DistributorAuthenticationError:
      type: object
      required:
      - reason
      - _tag
      properties:
        reason:
          type: string
        _tag:
          type: string
          enum:
          - DistributorAuthenticationError
      additionalProperties: false
      description: Authentication Error
    HttpApiDecodeError:
      type: object
      required:
      - issues
      - message
      - _tag
      properties:
        issues:
          type: array
          items:
            $ref: '#/components/schemas/Issue'
        message:
          type: string
        _tag:
          type: string
          enum:
          - HttpApiDecodeError
      additionalProperties: false
      description: The request did not match the expected schema
    PropertyKey:
      anyOf:
      - type: string
      - type: number
      - type: object
        required:
        - _tag
        - key
        properties:
          _tag:
            type: string
            enum:
            - symbol
          key:
            type: string
        additionalProperties: false
        description: an object to be decoded into a globally shared symbol
    Unauthorized:
      $id: /schemas/void
      title: Unauthorized
    Issue:
      type: object
      required:
      - _tag
      - path
      - message
      properties:
        _tag:
          type: string
          enum:
          - Pointer
          - Unexpected
          - Missing
          - Composite
          - Refinement
          - Transformation
          - Type
          - Forbidden
          description: The tag identifying the type of parse issue
        path:
          type: array
          items:
            $ref: '#/components/schemas/PropertyKey'
          description: The path to the property where the issue occurred
        message:
          type: string
          description: A descriptive message explaining the issue
      additionalProperties: false
      description: Represents an error encountered while parsing a value to match the schema
    ForbiddenError:
      type: object
      required:
      - reason
      - _tag
      properties:
        reason:
          type: string
        customErrorCode:
          type: string
          enum:
          - AccountDoesNotBelongToInvestor
          - SessionIsNot2FA
          - InvestorDocumentLinkedToActiveBankAccount
          - AtLeastTwoAdminUsersRequired
          - InvestorNotPendingOnboarding
          - ShareClassNotAvailableForDistributor
        _tag:
          type: string
          enum:
          - ForbiddenError
      additionalProperties: false
      description: Forbidden
    NonNegativeAmount:
      type: object
      required:
      - value
      - currency
      properties:
        value:
          type: string
          title: non-negative decimal number as a string
          description: a string representation of a non-negative decimal number e.g. "10000", "0.00" or "3420.92"
        currency:
          type: string
          enum:
          - EUR
          - USD
          - GBP
          - CHF
          - JPY
          - SGD
          title: Currency code
          identifier: CurrencyCode
          description: a currency code among "EUR", "USD", "GBP", "CHF", "JPY", "SGD"
      additionalProperties: false
      title: Non-Negative Amount
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Use your API client_id as username and client_secret as password.