> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > ## Agent Instructions (AIsa) > > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Paid calls need approval first. Docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP discovery are free to read. Before any paid, dynamically priced, or high-cost call, state the exact scope, rate, and maximum USD exposure, then wait for a separate user message approving that scope and cap. A request to collect data is not approval; do not send unapproved probes. Full rule: https://aisa.one/docs/llms.txt # Get earnings for user by date > Returns earnings for a user on a given date. Requires API key auth headers. ## Cost and request rules Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.012 * **Cost contract:** fixed\_success * **Settlement evidence source:** request\_snapshot ## OpenAPI ````yaml openapi/polymarket-clob.json GET /apis/v1/polymarket/rewards/user openapi: 3.1.0 info: description: '' title: Polymarket Clob version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/polymarket/batch-prices-history - /apis/v1/polymarket/book - /apis/v1/polymarket/books - /apis/v1/polymarket/builder/trades - /apis/v1/polymarket/cancel-all - /apis/v1/polymarket/cancel-market-orders - /apis/v1/polymarket/clob-markets/{condition_id} - /apis/v1/polymarket/data/orders - /apis/v1/polymarket/fee-rate - /apis/v1/polymarket/fee-rate/{token_id} - /apis/v1/polymarket/heartbeats - /apis/v1/polymarket/last-trade-price - /apis/v1/polymarket/last-trades-prices - /apis/v1/polymarket/markets-by-token/{token_id} - /apis/v1/polymarket/midpoint - /apis/v1/polymarket/midpoints - /apis/v1/polymarket/order - /apis/v1/polymarket/order-scoring - /apis/v1/polymarket/order/{orderID} - /apis/v1/polymarket/orders - /apis/v1/polymarket/price - /apis/v1/polymarket/prices - /apis/v1/polymarket/prices-history - /apis/v1/polymarket/rebates/current - /apis/v1/polymarket/rewards/markets/current - /apis/v1/polymarket/rewards/markets/multi - /apis/v1/polymarket/rewards/markets/{condition_id} - /apis/v1/polymarket/rewards/user - /apis/v1/polymarket/rewards/user/markets - /apis/v1/polymarket/rewards/user/percentages - /apis/v1/polymarket/rewards/user/total - /apis/v1/polymarket/sampling-markets - /apis/v1/polymarket/sampling-simplified-markets - /apis/v1/polymarket/simplified-markets - /apis/v1/polymarket/spread - /apis/v1/polymarket/spreads - /apis/v1/polymarket/tick-size - /apis/v1/polymarket/tick-size/{token_id} - /apis/v1/polymarket/time - /apis/v1/polymarket/trades x-aisa-document: facts_hash: 3ef99d33457af3e3c3b16299db54930852c884758cba034bdda67a08da5ab7fb generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '18' response_pending: [] document_hash: sha256:aed00c89a96bbab3b38960d7d0e84e6de5e6fa06dcd1840b2f903c9365eed009 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: polymarket-clob x-aisa-catalogs: polymarket-clob: title: Polymarket Clob description: '' x-aisa-document: facts_hash: 3ef99d33457af3e3c3b16299db54930852c884758cba034bdda67a08da5ab7fb generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/polymarket/rewards/user: get: tags: - default summary: Get earnings for user by date description: >- Returns earnings for a user on a given date. Requires API key auth headers. operationId: any_polymarket_clob_apis_v1_polymarket_rewards_user parameters: - name: date in: query description: Date in YYYY-MM-DD format required: true schema: type: string format: date example: '2024-03-26' - name: maker_address in: query description: Maker address to query earnings for required: false schema: type: string example: '0xFeA4cB3dD4ca7CefD3368653B7D6FF9BcDFca604' - name: next_cursor in: query description: Pagination cursor from previous response required: false schema: type: string - name: signature_type in: query description: | Signature type for address derivation (required for API KEY auth): - 0: EOA - 1: POLY_PROXY - 2: POLY_GNOSIS_SAFE required: false schema: type: integer enum: - 0 - 1 - 2 - name: sponsored in: query description: If true, returns sponsored-only earnings required: false schema: type: boolean default: false responses: '200': description: Successfully retrieved user earnings content: application/json: schema: $ref: >- #/components/schemas/ResponseE58613C05201_PaginatedUserEarnings example: limit: 100 count: 1 next_cursor: LTE= data: - date: '2024-03-26T00:00:00Z' condition_id: >- 0xbd31dc8a20211944f6b70f31557f1001557b59905b7738480ca09bd4532f84af asset_address: '0x9c4E1703476E875070EE25b56A58B008CFb8FA78' maker_address: '0xFeA4cB3dD4ca7CefD3368653B7D6FF9BcDFca604' earnings: 0.237519 asset_rate: 1 default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats x-codeSamples: - lang: text label: Reference example source: >- # Fixed reference example. Playground inputs do not update this sample. curl --request GET \ --url 'https://api.aisa.one/apis/v1/polymarket/rewards/user?date=2024-03-26&maker_address=0xFeA4cB3dD4ca7CefD3368653B7D6FF9BcDFca604' \ --header 'Authorization: Bearer ' components: schemas: ResponseE58613C05201_PaginatedUserEarnings: type: object description: Paginated list of user earnings properties: limit: type: integer description: Maximum number of items per page count: type: integer description: Number of items in the current response next_cursor: type: string description: Cursor for the next page. "LTE=" indicates the last page. data: type: array items: $ref: '#/components/schemas/ResponseE58613C05201_UserEarning' required: - limit - count - next_cursor - data ResponseE58613C05201_UserEarning: type: object description: User earnings for a specific market on a given day properties: date: type: string format: date-time description: Date of the earnings condition_id: type: string description: Condition ID of the market asset_address: type: string description: Address of the reward asset maker_address: type: string description: Address of the maker earnings: type: number format: double description: Amount of earnings in the asset asset_rate: type: number format: double description: Exchange rate of the asset required: - date - condition_id - asset_address - maker_address - earnings securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.